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PREFACE 



0.1 MANUAL OBJECTIVES AND READER ASSUMPTIONS 

This manual describes the operation of the Crash Dump Analyzer. It is 
intended for you if you are an experienced Assembly Language 
Programmer with a working knowledge of the RSX-llM Executive data 
structures. It does not describe the operation of the RSX-llM 
Executive or the significance of the individual data structures. 

Underlining is used in the examples of this manual to denote CDA 
generated text. Also, the term "offset mode" is used throughout 
Chapter 3. Offset mode means that the addresses shown are relative 
addresses from the beginning of the displayed data. They do not 
represent the physical or virtual addresses of the data. 



0.2 DOCUMENT STRUCTURE 

CHAPTER 1 explains the purpose of the Crash Dump Analyzer. It 
describes the minimum system configuration and the necessary 
procedures for obtaining a crash dump. It explains how to run CDA and 
describes the command string format. Finally, Chapter 1 describes 
indirect command files as they pertain to CDA. 

CHAPTER 2 describes the switches associated with CDA. Two summary 
tables provide quick reference on switch operation. Expanded 
descriptions for each switch follow each table. 

CHAPTER 3 consists of actual CDA output listings. Each entry of each 
listing is numbered to correspond to the numbered explanatory text 
preceding it. Cross reference information is provided where 
necessary. 

APPENDIX A contains a short description of each CDA error message. 

APPENDIX B consists of the RSX-llM system data structures as they 
appear in the source listings. 



0.3 ASSOCIATED DOCUMENTS 

Refer to the RSX-llM/RSX-llS Documentation Directory , for a brief 
description of each manual in the RSX-llM, Version 3.1, documentation 
set. 
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CHAPTER 1 
INTRODUCTION 



The Crash Dump Analyzer (CDA) is a specialized utility that helps you 
establish the cause of system crashes. CDA reads the contents of the 
memory dump created by the Executive Crash Dump Routine. It analyzes 
the dump in accordance with the information contained in the Executive 
Symbol Table file, RSXllM.STB. Finally, CDA outputs the dump to a 
print device in a human-readable format for your evaluation. 

CDA is a nonprivileged task that any nonprivileged user can run. 



1.1 SYSTEM REQUIREMENTS 

To obtain a crash dump suitable for input to CDA, you must build the 
Executive Crash Dump Routine into your system at SYSGEN. You must 
also have one of the following hardware units in addition to your 
system disk. 

RK05 disk unit 

Magtspe unit 

DECtape unit 

You can build the Executive Crash Dump Routine into your system during 
phase 1 of SYSGEN beginning with the query: 

DO YOU WANT CRASH DUMP ANALYSIS SUPPORT? [Y/N] : 

If you select this option, code will be included in your system to 
dump memory to one of the secondary storage devices listed above 
following a system crash. Also, if you select this option, the 
following dialogue will occur: 

ENTER OUTPUT DEVICE CSR ADDRESS [0 R: 160000 : 177700 D:177564]: 

The output device is the device upon which you want notification of 
system crashes to appear. The legal range of octal addresses for this 
device is 160000 through 177700. If you do not specify an address in 
response to this query (that is, you enter only a carriage return), 
crash notifications will appear on your console terminal. The default 
address for the console terminal is 177564. 

The remaining dialogue relates to your secondary storage device. 
ENTER CRASH MEMORY DUMP DEVICE MNEMONIC [S] : 
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Your response to this query will be one of the following: DK for 
RK05, MM for TU16, TE16, or TU45 Magtape, MT for TUlO, TElO, or TS03 
Magtape, or DT for DECtape. The dialogue will continue with: 

WHAT IS ITS CSR ADDRESS? [O R: 160000 : 177700 D:device dependent] 

The legal range of octal addresses for this device is also 160000 
through 177700. If you do not specify an address for this device, the 
default address will be taken. The default address will be determined 
by which device you have chosen. The default addresses are: 177404 
for DK, 172440 for MM, 172522 fot MT, and 177342 for DT. 

The final query is: 

WHAT IS THE PHYSICAL UNIT NUMBER OF THE CRASH UNIT? [0 R:0-7 D:0]: 

The legal range of responses for this query is through 7. If you do 
not specify a physical unit number, the default will be taken which is 
0. 



1.2 OBTAINING A CRASH DUMP 

To obtain a crash dump, control of the processor must be transferred 
to the Executive Crash Dump Routine following a system crash. How 
this control is transferred depends on the way in which the crash 
occurred and whether or not you have built the Executive Debugging 
Tool (XDT) into your system at SYSGEN. 

System crashes occur in three ways: 

1. The processor encounters an unintentional halt instruction 

(000000) . 

2. An infinite loop condition occurs. 

3. The processor encounters a program condition which causes it 
to trap. 

When a program condition causes a processor trap and XDT is included 
in your system, control will transfer automatically to XDT. You can 
then type X at your terminal and XDT will transfer control to the 
crash dump routine. (Refer to the RSX-llM Guide to Writing an I/O 
Driver for a description of XDT.) 

When XDT is not included in your system, a processor trap causes 
control to be transferred to the crash dump routine. 

When a system crash is the result of an unintentional HALT instruction 
or an infinite loop condition, you must restart your processor at 
location 40. 

NOTE 

If you have included the register and 
stack dump option into your system at 
SYSGEN, the contents of the general 
registers and the Executive stack will 
always be output prior to entry into the 
crash dump routine. 
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Regardless of the manner in which control is transferred, once the 
crash dump routine is entered, it prints the following message on the 
crash notification device specified at SYSGEN: 

CRASH-CONT WITH SCRATCH MEDIA ON (device mnemonic) 

You can then put the secondary crash dump device on-line and depress 
the CONT switch on the CPU console. The crash dump routine will dump 
memory to the crash dump device and halt the processor upon 
completion. 



1.3 RUNNING CDA 

You can run CDA as either an installed task or as an uninstalled task. 

As an installed task, use the following format to return control to 
the Executive upon completion of the analysis: 

>CDA command string <CR> 

To return control to CDA upon completion of the analysis, use the 
following format: 

>CDA <CR> 

CDA> command string <CR> 

When you run CDA as an uninstalled task, control is always returned to 
CDA upon completion of the analysis. The commands for running CDA 
are: 

RUN $CDA <CR> 

CDA> command string <CR> 

which requires that CDA.TSK be present in the UFD corresponding to the 
sysuem Uic on device LB:. An alternate command is 

RUN CDA <CR> 

CDA> command string <CR> 

which requires that CDA.TSK be present in the UFD corresponding to the 
current UIC on SY:. 



1.4 CDA COMMAND STRINGS 

You must use the following format to input commands to CDA: 

[list file/sw] , [binary f ile/sw] =symbol file/STB, crash-input [/sw] 



where: 



[list file] is the optional human-readable CDA output listing. 
This listing is described in Chapter 3 of this 
manual. 

[binary file] is an optional binary file. This file is a copy 
of the binary data that was written to the crash 
dump device by the crash dump routine. It allows 
you to selectively create a historical record of 
crash dumps. Also, if you specify this file 
during an initial analysis, you can use it for 
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input to CDA at a later time. Since the crash 
dump routine will overwrite the information on 
your crash dump volume with each dump to it, this 
feature allows you to use a single volume for all 
crash dumps. 
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crash-input 



[/sw] 



symbol file/STB ^ ^ u ^ 

is the symbol definition file for the crashed 
system. The /STB switch is an integral part of 
this file specification. You must use this file 
specification and switch in all CDA command 
strings. 

is the binary input to CDA. This specification 
can be either a device name (your secondary 
storage device) , or a binary file specification 
that was created during a previous CDA run. If it 
is a binary file specification, the "binary file" 
field in the output must be left blank. 

is an optional CDA switch. Each switch is 
associated with a specific file specifier and 
cannot be used alone or in conjunction with other 
file specifications. Each switch is described in 
detail in Chapter 2. 

Output specifications to the left of the equal sign are position 
dependent. Therefore, when you include both output specifications, 
you must place them in the command string in the positions shown. If 
you omit the list file, you must place a comma before the binary file 
specification. 

Input specifications to the right of the equal sign are position 
independent and can appear in either order. 

Any of the specifications in the command string can appear in complete 
FILES-11 format — that is, complete with device, UIC, filename, file 
type, and version number. When you omit any of the elements, CDA uses 
the defaults shown in Table 1-1. Note that not all of the elements m 
all specifications have defaults. 



Table 1-1 
File Default Values 









Default Vc 


ilue 


File 


Device 


UFD 


File name 


Type 


listing file 


SY: 


current 


none 


.LST 


binary file 


SY: 


current 


none 


.CDA 


symbol file/STB 


SY: 


current 


RSXllM 


.STB 


crash-input 


SY: 


current 


none 


.CDA 



1* 
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The following examples illustrate the CDA file default values. Assume 
that the user in these examples is logged in under UIC [301,356] and 
that the secondary storage device is DTI:. Also, assume that CDA is 
being operated as an installed task. 

EXAMPLE 1: 

CDA<CR> 

CDA> 190CT77 , 190CT77=RSXllM. STB/STB , DTI : 

This command string will create: 

1. A listing file, 190CT77.LST, under UFD [301,356] 

2, A binary file, 190CT77.CDA, under UFD [301,356] 

The binary input is read from DECtape Unit 1 and CDA analyzes it in 
accordance with the information contained in the symbol definition 
file RSXllM.STB under UFD [301,356]. 

EXAMPLE 2: 

CDA<CR> 

CDA> , 190CT7 7= [ 1 , 54 ] /STB , DTI : 

This command string will create a binary file, 190CT77.CDA, under UIC 
[301,356] . 

The binary input is read from DECtape Unit 1 and CDA analyzes it in 
accordance with the information contained in the symbol definition 
file RSXllM.STB under UFD [1,54].' 

EXAMPLE 3: 

CDA<CR> 

CDA>LP:=[1,, 54]/STB,190CT77 

This command string will create an output listing on device LP:. 

The binary input is read from a previously created binary file, 
190CT77.CDA, and CDA analyzes it in accordance with the information 
contained in the symbol definition file, RSXllM.STB, under UFD [1,54]. 



1.5 INDIRECT COMMAND FILES 

As with other utilities, you can enter command strings to CDA directly 

from the keyboard or indirectly through use of the indirect command 

file facility. CDA indirect command files are limited to one level of 

indirection. That is, an indirect command file must not contain a 
reference to another command file. 
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1.6 BASIC CDA OUTPUT LISTING ^ 

While the Crash Dump Analyzer provides many output listing options, ^; 
fundamental system information always appears on the first five pages 
of output listing. These first five pages contain the following: 

Page 1 — Volatile Registers 

Page 2 — Kernel Stack 

Page 3 — System Common 

Page 4 — System Common Labeled Dump 

Page 5 — Pool Statistics 

Sections 3.1.1 through 3.1.5 of this manual describe these pages in 
detail. 

In addition to these pages, a sixth page, Error Log Buffers, will be ^ 
included in your output listing if error log information was in memory ■. 
at the time of the crash. (Refer to the RSX-llM Error Logging ^^ 
Reference Manual for more information) . This page is described in 
detail in Section 3.1.6 of this manual. 
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CHAPTER 2 
SWITCHES 



Switches provide you with the means to control Crash Dump Analyzer 
operation. There are two types — Analysis switches and Function 
switches. 

Analysis switches determine which CDA analysis routines will be 
applied to the crash-input. 

Function switches provide a number of control options. For example, 
such switches might terminate an analysis after CDA has encountered a 
specified number of errors. Or , a switch might limit the number of 
pages of output listing. 

Both types of switches are file specific. That is, each switch 
applies to a particular file and may not be used either alone or with 
any other file. 



2.1 ANALYSIS SWITCHES 

Table 2-1 summarizes the Analysis switches and gives a brief 
description of their effect. Following Table 2-1 is an expanded 
description of each switch. 



Table 2-1 
Summary of CDA Analysis Switches 



Switch 


Meaning 


Applies to 
File 


/ACT 


Lists the contents of the Task 
Control Blocks for each active 
task 


crash-input 


/ALL 


Lists the output of all 
analysis Routines 


crash-input 


/CLQ 


Lists the contents of the 
clock queue 


crash-input 


/DEV 


Lists information on all 
devices in the system 


crash-input 


/DUMP:a:b 


Lists the contents of physical 
memory between address a and 
address b 


crash-input 



(Continued on next page) 
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Table 2-l(Cont.) 
Summary of CDA Analysis Switches 



Switch 


Meaning 


Applies to 
File 


/HDR 


Lists the contents of the task 
headers for each task resident 
in memory 


crash-input 


/PCB 


Lists the contents of each 
Partition Control Block 


crash-input 


/POOL 


Lists the contents of the 
system pool 


crash-input 


/TASK=name:a:b 


List the contents of task 
"name" between virtual address 
a and virtual address b 


crash-input 


/STD 


Lists the contents of the 
System Task Directory for all 
tasks 


crash-input 



I 



2.1.1 /ACT (Task Control Blocks for active tasks) 

FILE: crash-input 

EFFECT: CDA scans the System Task Directory and lists the contents of 
the Task Control Blocks for each active task. 



I 



2.1.2 /ALL (all analysis routines) 

FILE: crash-input 

EFFECT: CDA will apply all of its analysis routines (except those 
associated with memory and task dumps) to the specified 
crash-input. The output from these routines will be listed 
in the following order: 

1. System Information 

2. Active Tasks 

3. Task Headers 

4. Partition Information 

5. Device Information 

6. System Task Directory 

7. Fixed Tasks 

8. Pool Dump 
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2.1.3 /CLQ (clock queue) 

FILE: crash-input 

EFFECT: CDA lists the contents of the clock queue. 
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2.1.4 /DEV (all devices in system) 

FILE: crash-input 

EFFECT: CDA scans the system device tables and lists the contents of 
the control blocks for each device in the system. 



2.1.5 /DUMP:a:b (list physical memory) 

FILE: crash-input 

EFFECT: CDA lists the contents of physical memory between the 18-bit 
octal addresses a and b inclusive. 



2.1.6 /HDR (headers for memory-resident tasks) 

FILE: crash-input 

EFFECT: CDA scans the System Task Directory and lists the contents of 
the Task Headers for each task resident in memory. 



2.1.7 /PCB (Partition Control Blocks) 

FILE: crash-input 

EFFECT: CDA outputs a map that lists all the occupants of memory and 
the contents of each Partition Control Block. 



2.1.8 /POOL (System pool) 

FILE: crash-input 

EFFECT: CDA lists the system pool in octal, RAD50 and ASCII. 

2.1.9 /TASK=name:a:b (task virtual address space) 

FILE: crash-input 

EFFECT: CDA lists the virtual address space of task "name" between 
the 16 bit virtual addresses a and b inclusive. If you do 
not specify addresses, CDA lists the tasks entire virtual 
address space. 

2.1.10 /STD (System Task Directory) 

FILE: crash-input 

EFFECT: CDA scans the System Task Directory and lists the contents of 
all Task Control Blocks linked into it. 
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2.2 FUNCTION SWITCHES 

Table 2-2 summarizes the Function switches and gives a brief 
description of their effect. Following Table 2-2 is an expanded 
description of each switch. 



Table 2-2 
Summary of CDA Function Switches 



Switch 


Meaning 


Applies to 
File 


Default 


/BL:n 


Identifies the starting block 
number of the crash-input 
device. The value of n must be 
less than 65535, 


crash- 
input 


n=100 


/EXIT:n 


Terminate analysis after 
encountering n analysis errors 


list file 


— 


/LIMIT:n 


Limit output listing to n 
pages 


list file 


n=300. 


/MEMSIZ:n 


Create a binary output file 4*n 
blocks long 


binary 
file 


124. K * 


/KMR 


Force the assignment of Page 
Address Register values for the 
crashed system 


crash- 
input 


— 


/-SP 


Do not spool analysis output 
listing. 


list file 


/SP 


/STB 


Identifies the file 
specification that contains the 
Executive Symbol Table 


symbol file 


— 



* n can be expressed as an octal or decimal number. A dot 
following the number denotes decimal. 



2.2.1 /BL:n (identify starting block number) 

FILE: crash-input 

EFFECT: CDA reads the dump from the input device beginning at block 
n. If the crash dump device is not a disk or DECtape, CDA 
ignores this switch. 



DEFAULT: 



n = 100 octal 
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2.2.2 /EXITrn (exit after n errors) 

FILE: list file 

EFFECT: CDA maintains an error count. As it encounters 
inconsistencies in the system data structure, it increments 
this count. If you specify the /EXIT:n switch, CDA 
terminates analysis after n errors. If you specify the 
/EXIT switch but do not specify n, CDA exits after 1 error. 

DEFAULT: No exit 



2.2.3 /LIMIT: n (limit output listing) 

FILE: list file 

EFFECT: The /LIMIT:n switch limits the number of pages of analysis 
output. When CDA has generated n pages it terminates the 
analysis and prints a message on the user terminal 
indicating that it has done so. 

DEFAULT: n = 300. pages 



c 



2.2.4 /MEMSIZrn (establish size of binary output file) 

FILE: binary file 

EFFECT: This switch causes CDA to create a Binary Output File 4xn 

blocks long and to transfer nK words to it from the 

crash-input file. The value of n must be between 16. and 
124. inclusive. 

This switch is particularly useful when transferring raw 
binary crash dumps from disk or DECtape. Since disks and 
DECtapes have no physical EOFs, it is necessary to specify 
the size of the actual memory dump. 

When the crash input resides on magtape, the binary output 
file will be zero filled if the EOF is read before nK words 
have been transferred. 



NOTE 

Tasks above 124K physical memory (11/70 systems 
only) cannot be analyzed. 



DEFAULT: 



n = 124. K 



c 
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2.2.5 /KMR (assign kernel mapping register values) 

FILE: crash-input 

EFFECT: On mapped systems, when CDA reads incorrect Page Address 
Register (PAR) values from the crash stack, it aborts the 
analysis and prints an error message on the terminal. In 
this event, you can use the /KMR switch to restart the 
analysis. When you specify /KMR, CDA is forced to use 
standard mapping values to convert kernel virtual addresses 
to physical memory addresses. 

DEFAULT: CDA uses existing Page Address Registers. 



2.2.6 /-SP (do not spool) 

FILE: list file 



EFFECT: 



DEFAULT: 



CDA does not spool the analysis output listing to the line 
printer. It creates an output listing file on the device 
indicated in the output file specification. If you have not 
specified a device, CDA creates the file on SYO:. 

/SP 



2.2.7 /STB (preceding file contains the Executive Symbol Table) 

FILE: symbol file (RSXllM.STB) 

EFFECT: The /STB switch identifies the file containing the Executive 
Symbol Table. This file must correspond to the crashed 
system. CDA opens the specified file and extracts the 
necessary symbol values. If it fails to find any required 
symbol values, CDA aborts the analysis and prints an error 
message on the terminal. 

DEFAULT: RSXllM.STB 



I 
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CHAPTER 3 
ANALYSIS LISTINGS 



The example CDA output listings in this chapter illustrate CDA 
operation. Each item of each listing is keyed to the brief 
explanatory text that precedes it. Cross references direct you to 
other documents that contain descriptions of the individual data 
structures. 

NOTE 

These listings were extracted from 
several different crash dumps. 
Therefore, values that would normally 
correlate across the various listings 
will not necessarily correlate here. 
Those listings that would extend across 
several pages in an actual dump of a 
crashed system have been truncated and 
reflect only a typical printout format 
for that listing. 



3 . 1 SYSTEM INFORMATION 

The first five pages of every CDA output listing contain the system 
information described in Sections 3.1.1 through 3.1.5. When Error Log 
information is in memory at the time of the system crash, the example 
listing described in 3.1.6 will appear in CDA's output listing as Page 
6 of System Information. 



3.1.1 Volatile Registers 

Figure 3-1 is an example listing that reflects the state of the 
hardware at the time of the crash. Refer to the appropriate PDPll 
processor handbook for detailed information on these registers. Each 
item in the following list describes a correspondingly numbered item 
in Figure 3-1. 

Item Description 

1. Cause of crash 

2. Contents of Processor Status Word, kernel and user 
stack pointers following crash 

3. Program Counter and Processor Status Word that the 
system pushed onto the kernel stack just prior to 
system crash (These values will be- valid only if the 

system trapped) 

3-1 



4, 
5. 
6. 
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General registers 

Contents of Memory Management Registers 

Contents of Page Address and Page 
Registers 



Description 



Unibus map registers (This field is suppressed if the 
processor is not an 11/70) 



RSX-llH CRASH DUMP ANALYZER 
VOLATILE REGISTERS 



V3.1 



22-SEP-77 leiK 



PAGE 1 



CAUSE OF CRASHj MANUAL DUMP BY OPERATOR© 

AFTER CRASHj PS=0a0340 SP (K) a00(3600 SP CU) 8001442 
BEFORE CRASHt PCsifXblbb PSs0300000 

R0s000i«13 R1S100030 R23000013 R330000t3 R4se000>;0 
MMR?r000("iOl MMR1300U5)00 MMR2S001572 MMR350000600 



RSaB63354 © 



USER 



I S P 


ACE 


D S P 


ACE 


PDR 


PAR 


PDR 


PAR 


077506 


O0000(* 


000000 


000000 


077406 


000200 


000000 


000000 


0774?6 


000400 


000000 


000000 


0774^6 


00?600 


000000 


000000 


5»775(?6 


001000 


000000 


000000 


0775(»6 


004477 


000000 


000000 


0774l>6 


004677 


000000 


000000 


077406 


17760a 


000000 


000000 



SUPERVISOR 



I S P 


ACE 


D S P 


ACE 


PDR 


PAR 


PDR 


PAR 


0si0eefi 


000000 


000000 


000000 


0ii00e>4 


aaaaat! 


000000 


000000 


000061^1 


000000 


000000 


000000 


0510k10i« 


00iaa0fc 


000000 


000000 


0e000if; 


13003061 


000000 


000000 


0f»0a0e 


P000?P 


000000 


000000 


00000lcl 


000l£0t^ 


000000 


000000 


000000 


000000 


000000 


000000 



KERNEL 



I S P 


A C E 


POR 


PAR 


077506 


000000 


077506 


1(900200 


077506 


000400 


0775e6 


000600 


077506 


001000 


077406 


004477 


077406 


004677 


077506 


177600 



D S P 


ACE 


PDR 


PAR 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 . 



UNIBUS MAPI 



© 



1 


00000000 


2 


00020000 


1 


00040000 


4 


00060000 


5 


00100000 


6 


003S2644 


7 


00000000 


8 


00000010 


9 


00200010 


10 


00000000 


11 


00000010 


12 


00000000 


13 


00000012 


14 


00000010 


15 


00000000 


16 


00000000 


17 


00000000 


18 


00000000 


19 


00000010 


20 


00000000 


21 


00020000 


22 


00000000 


23 


00000000 


24 


00000000 


25 


00000000 


26 


00000000 


27 


00000000 


28 


00000000 


29 


00000000 


30 


00000000 


31 


00000000 



© 



Figure 3-1 Volatile Registers 
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3.1.2 Kernel Stack 

Figure 3-2 is an example listing that shows the contents of the kernel 
stack area beginning at V$$CTR and ending at $STACK. The kernel stack 
Dointer will point to a location within this area. 



RSX-ll'- CRtSM DUMP ANALYSES V3,l 22-StP-77 l^*ii<i PAGE ? 

KERNEL STaCf> 

Rff'^tU stack; 



( 



'.'iP'ii'^i' 


ii;ii3k)iZ0 


■3^0000 


000300 


000000 


0iS0P!00 


005'a0? 


000000 


000000 


'ii^■il,•U^^ 


viii0»ok?ei 


.?30fl00 


110000^ 


000000 


0i1110?0 


0P«/0«0 


000000 


V300000 


^ i/» i' u a t^ 


i>0i3u'.\^ii 


«e00«a 


0ap!5!0?i 


{100000 


0'^0i'P0 


?l10000 


000000 


000000 


in: ,'4 6,1 


^^^'..^^^> 


^30i?il2.0 


0001,100 


0',^0000 


0.10000 


0ii30^2 


122710 


122455 


ant Sir-' 


126i'fc^ 


P««a62 


07fe02« 


117a5i? 


022510 


116330 


002463 


023704 


ifiriL'Sa.' 


,1.15677 


.1017 32 


122710 


122a67 


0/2363 


177574 


122501 


126060 


^i-'if'idi. 


'^b^i}^^ 


IbiHilii 


127^106 


140016 


0i5l223 


(f04U62 


067220 


117450 


/n'i'Sfi.^ 


:>Bi<3lS 


11653^ 


0il)0000 


007436 


0i1t'l»00 


fn'assk' 


046206 


065354 


ifl<:<fit<^i' 


i?16766 


.13000*; 


02216-^ 


123650 


0*32306 


lllf'pii' 


000000 


10010? 


v^inea? 


^bllSU 


00030? 


06355i* 


123666 


t70i^0.' 









Figure 3-2 Kernel Stack 



3.1.3 System Common 

The example listing in Figure 3-3 provides a selectivei interpretation 
of some of the items in System Common. Each item in the list 
describes a correspondingly numbered item in Figure 3-3. (Refer to 
the RSX-llM Guide to Writing an I/O Driver for more information.) 

Item Description 

1- Time and date of crash 

2. The task that was running at the time of the crash. 
If no task was executing at the time of the crash, 
this field will contain NULL TASK. This condition 
could develop if all the active tasks are in a blocked 
state at the time of the crash 

3. The address of the first word of the task control 
block of the current task 

4. The contents of the 4-byte system ID indicating system 
base level 

5. The first address available for partitions (the last 
address of the Executive + 1) 

6. The system size in 32 word blocks and then in total 
words 

7. System UIC 
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8, 

9, 

10. 

11, 

12. 
13. 

14. 



Stack depth count 

Contents of the global event flag words 

Device from which the system was booted 

Logical Block Number of the beginning of the system 
image 

Size of system in blocks 

The octal value of the system feature mask and the 
meaning of each set bit 

Octal dump of System Common in offset mode from $CMBEG 
through $CMEND 



< 



RSX-UH CRASH DUMP ANAUVZER 
SYSTEM COMMON 



V3.1 



22-SEP-77 



letta 



PACE 3 



CRASH OCCURRED AT 09i24:fl3 2-SEP-77 

© © 

CURRENT TASK = DM0T2 TCB ADDRESS ■ 067222 

© ® © 

5SYSID = lb JEXSIZ a 120000 SSYSIZ = 16364, /512K 

© © 

SSTKDP s eiae000 SCOMEFJ <i3-ue> 000080 <«9-6U> 000000 

® ® @ 

LOAD DfcVICE a DB0 L8N s 0070«4ll FILE SIZE a 496. 



© 
SSYUIC I [4,54] 



SrSTt^ FPATuPE '>^iSK 
BIT SET 



3.5 ("377 

MEANING 



EXT 

MUP 

EXV 
DHV 
PLA 
CAL 
PKT 
EXP 



11/70 EXTENDED MEMORY SUPPORT 

MULTI-USER PROTECTION SUPPORT 

20K EXEC SUPPORTED 

LOADABLE DRIVER SUPPORT 

PLAS SUPPORT 

DYNAMIC CHECKPOINT SPACE ALLOCATION 

PREALLOCATIOn OF 1/0 PACKETS 

EXTEND TASK DIRECTIVE SUPPORTED 



I 



SYSTE^^ COMMON (SCMBEG THRU JCMEND) : 



00li!0(^0 
00(^02(9 

000l36l(< 

^^el0^) 
00i?l2*« 

000140 
P?016f 

00l<!201i« 

00^220 
00024b) 
000260 

00t»300 

000320 
0003411* 



006230 
0^0000 

00000P 

020«37 
116330 
064072 
001377 

000000 

002054 
006334 
000040 
020000 
000000 
00001S 
000002 



030141 

000000 
0^^0000 

320037 

300000 
000000 

014536 
■341061 

000000 

116330 

000100 
040000 
000000 
000037 
000011 



000000 
000000 
006312 
017440 
114260 
000000 
063776 
020040 
000000 
000000 
000200 
100000 
040000 
000030 

000030 



000000 
000046 
160607 
017440 
120000 
023530 
063644 
114460 
172000 

000001 
000400 
000000 
001400 
000074 
000053 



117734 
160607 
050756 

020040 
066304 
177777 

et06216 
000000 
010000 
000002 
001000 
006504 
100411 
000074 
000001 



170010 
000U00 
116330 
006250 
000612 

000000 

077504 
177546 
066560 

000004 
002000 

001000 

04ueu 

00007U 
067420 



050732 
067220 
024577 
000001 
077406 

000000 

000000 
177546 

000000 
000010 
004000 
000000 
000760 
000115 
005010 



000000 
000000 
020035 
006334 
000003 
006352 

(900000 

000000 
000000 
il00020 
010000 
000000 

177777 

000011 

177777 J 



Figure 3-3 System Common 
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3.1.4 System Common Labeled Dump 

The example listing in Figure 3-4 represents some of the locations in 

System Common which have a label associated with them. The octal 
numbers represent the contents of those locations,- not the addresses 

of the labels. The following lists the labels and their meanings. 

$ABTIM Absolute time counter 

$ACTHD Active task listhead 

$CFLPT Pointer to first checkpoint file 

$CKCNT Address of clock count register 

$CKCSR Clock Control Status Register (CSR) 

$CKLDC Clock load count 

$CLKHD Clock queue list head 

$COPT Pointer to console output Unit Control Block (UCB) 

$CRAVL Dynamic storage listhead 

$DEVHD Pointer to first Device Control Block (DCB) 

$ERRPT Pointer to error logger Task Control Block (TCB) 

$ERRSQ Universal error sequence number 

$ERRSZ Resident bytes of error logging data 

$EXSIZ Executive size 

$FMASK ■ System feature mask 

$FRKHD Fork queue listhead 

$HEADR Pointer to current task header 

$INTCT Clock interrupt ticks count 

$LDRPT Pointer to loader TCB 

$LOGHD Logical device assignment list 

$LSTLK Lock word — TCB address of owner 

$MCRCB MCR Command Block address 

$MCRPT Pointer to MCR TCB 

$MXEXT Last address in system common 

$PARHD Pointer to partition list 

$PARPT Parity address vector table pointer 

$PKAVL Pointer to first preallocated packet 

$PKMAX Maximum number of preallocated packets 

$PKNUM Number of preallocated packets in list 
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$PWRFL Powerfail recovery request flag 

$RQSCH Schedule request TCB address 

$SHFPT Pointer to shuffer TCB 

$SIGFL Task waiting for significant event 

$STKDP Stack depth indicator 

$SYUIC System User Identification Code (UIC) 

$TKNPT Pointer to TKTN TCB 

$TKPS Ticks per second 

$TKTCB Pointer to current task TCB 

$TSKHD Pointer to System Task Directory (STD) 



RSX-UM CRASH DUMP ANALYZER 
SYSTEM COMMON LABELED DUMP 



V3.1 



ll-NOV-77 



14t3ia 



PAGE U 
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SCFLPT 053U2t 

SCLKHD 052270 

SERRPT 064020 

SFMASK 180376 

SLORPT 053250 

SMCRPT lP523a 

SPKAVL 055760 

SRQSCH 005742 

SSYUIC 002054 

STSKHD 053250 

Figure 3-4 System Common Labeled Dump 



lABTlM 


111334 


SACTHD 


053250 


SCKCSR 


177546 


SCKLDC 


000000 


SCRAVU 


053340 


SDEVHD 


044306 


lERRSZ 


000000 


SEXSIZ 


110000 


SMEAOR 


065524 


SINTCT 


177777 


SLSTLK 


000000 


SMCRCB 


000000 


SPARHD 


053214 


SPARPT 


013144 


SPKNUM 


007417 


SPWRFL 


000000 


SSIGFL 


000000 


JSTKDP 


000000 


ITKPS 


000074 


STKTCB 


060510 



SCKCNT 177546 

ICOPT 052762 

tERRSQ 1^30005) 

SF»<KHD a^30fl0 

ILOGHD 05533« 

4MXEXT 0312(»(» 

SPKHAX 0^0017 

SSHFPT 10455^1 

STKnPT I0a51i?t 



3.1.5 Pool Statistics 

The example listing in Figure 3-5 contains information concerning the 
System Pool. CDA derives items 2, 3, and 4 by scanning the free block 
pointers of the pool. The minimum block size (Item 5) is derived from 
the contents of $CRAVL-2. Each item in the following list describes 
an item in Figure 3-5. 

Item Description 

1. Pool size in decimal bytes 

2. The largest block of contiguous words of pool space 

3. Total number of free bytes in pool 
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( 



4. Number of contiguous blocks not allocated 

5. Smallest possible block — this is the minimum number 
of bytes which may be requested 

6. Bit map in octal (block free if bit is set) 



RSX-ll^t CRASH DUMP ANALYZER 
POOL STATISTICS 



V3,l 



22-SEP-77 10I1B 



PAGE 5 



c 



POOL SIZE (BYTES) = U158.© 
LARGEST FREE BLOCK (BYTES) » 5516.0 
TOTAL FREE BYTES a 6288.0 
NUMBER OF FRAGMENTS > 30.0 
MINIMUM BLOCK SIZE (BYTES) s a.0 

POOL BITMAP (CONSTRUCTED FROM LINKED POOL* BLOCK FREE IF BIT SET) I 



( 



000203 


060400 


000014 


140000 


003617 


000000 


000000 


000000 


eidi?«0?i 


000000 


000000 


000000 


006000 


000000 


000040 


017000 


tfUfiidl^ 


000000 


000400 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000376 


000000 


000000 


003776 


000000 


000000 


^(,30002 


000000 


000000 


170000 


007777 


007700 


000000 


000000 


0d0k!0ei 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


«0ei(?00 


000000 


5)00000 


000000 


000000 


000000 


000000 


000000 


0!i!00at) 


000000 


000000 


000000 


000000 


000000 


000000. 


000000 


id^izaav 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


1200000 


000000 


000000 


077700 


000004 


000000 


000370 


000000 


17760t' 


000177 


000016 


000000 


174000 


000037 


000000 


176000 


077777 


000000 


000000 


100000 


000077 


000700 


160000 


177777 


003777 


000000 


000000 


017400 


000000 


000000 


000000 


170000 




177777 








177777 


177777 


177777 




177777 








177777 


177777 


177777 




17 f f r f 








17777? 


177777 


177777 




mm 








177777 


177777 


177777 




mm 








177777 


177777 


177777 




mm 








177777 


177777 


177777 




mm 








177777 


177777 


177777 




mm 








177777 


177777 


177777 




177777 








177777 


177777 


177777 




177777 








177777 


177777 


177777 




xmn 








077777 


100000 


077777 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


000000 


11)00000 


000000 


000000 


000000 


000000 


000000 







© 
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Figure 3-5 Pool Statistics 



3.1.6 Error Log Buffers 

The listing shown in Figure 3-6 contains error logging information 
that was residing in memory at the time of the crash. This data was 
not written to the Error Logging file on disk and could be an 
indication of the cause of the crash. (Refer to the RSX-llM Error 
Logging Reference Manual, Version 3.1.) 
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Item Description 

1. Address of error log buffer 

2. Error Code 

3. Time and date 

4. Dump of error log buffer in octal 

RSX-UW CHA5H DUMP ANALYZER VS. I 19-SEPT-77 17l53 PAGE 6 
ERROR LOG BUFFERS 

© © 

eUFFtR ADDRESS s 116330 ERROR CODE = 000001 

TIME CD-M-Y HiMiS) = 9-19-77 I7«52l59© 

000000 116460 000022 000004 000115 000011 000323 000021 000064 1 
eidea2vi 000003 000000 000000 000004 000000 000000 020040 020040 >0 

i^ftdHH 020040 020040 J 

Figure 3-6 Error Log Buffers 



3.2 OPTIONAL INFORMATION 

CDA gives you additional information when you use the analysis 
switches described in Chapter 2. Figures 3-7 through 3-16 illustrate 
the kind of output CDA provides when you use these swtiches. 



3.2.1 Active Tasks 

The listing shown in Figure 3-7 contains active task information. The 
Receive Queue, AST Queue, and Receive by Reference Queue sections of 
this example will appear only when they apply. Otherwise, they are 
suppressed. 

Item Description 

1. Task name 

2. Address of Task Control Block for the task 

3. The name of the partition in which the task runs 

4. Address of the Partition Control Block 

5. The base address for the partition in which the task 
runs 

6. The device that contains task image 

7. The beginning Logical Block Number of the task on the 
device 

8. The running priority 

9. The number of outstanding QIC requests 

10. Current UIC. This is either the log-on UIC or the UIC 
specified with the MCR SET command 

3-8 
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11. Physical name of tasks pseudo device 

12. Maximum size of task image in 32. word blocks 

13. State of local event flags for task 

14. First status word (blocking bits) . The 3-letter codes 
have the following meanings 

-EXE - task not executing 

RDN - I/O run down in progress 

MSG - abort message being output 

NRP - task mapped to nonresident partition 

OUT - task is out of memory 

CKP - task is being checkpointed 

CKR - task checkpoint requested 

15. Second status word (state bits) — the 3-letter codes 
have the following meaning: 

AST - Asynchronous System Trap (AST) in progress 

DST - AST recognition disabled 

-CHK - task not checkpointable 

CKD - checkpointing disabled 

GEF — stopped for event flag 

FXD - task fixed in memory 

TIO - task is engaged in terminal I/O 

CAF - dynamic checkpoint space allocation failure 

HLT - task is being halted 

ABO - task marked for abort 

STP - task stopped 

SPN - task suspended 

WFR - task in wait-for state 

16. Third status word (attribute bits) — the 3-letter 
codes have the following meaning: 

ACP - task is an Ancillary Control Processor 

-PMD - absence of the -PMD code indicates that the task 
will be dumped if it is abnormally aborted 

REM - remove task on exit 

PRV - task is privileged 
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MCR - task requested as an external MCR function 

SLV - task is a slave task 

CTL - task was activated by a controlling task 

RST - task is restricted 

NSD - task does not allow send data 

CAL - task has checkpoint space in task image 

ROV - task has resident overlays 

NET - network protocol level 

17. Octal dump of Task Control Block in offset mode 
RECEIVE QUEUE (if task has one) 

18. Starting address of receive block 

19. Octal dump of receive queue in offset mode 
AST QUEUE (if task has one) 

20. Address of AST block. 

21. A two byte indicator. The high order byte is an 
offset into the header of the AST control block. The 
low order byte is the length of the AST control block 
in bytes 

22. Number of bytes allocated on task stack 

23. Entry point of AST routine 

24. Number of AST parameters 

25. Octal dump of the AST block in offset mode 
RECEIVE BY REFERENCE QUEUE (if task has one) 

26. Address of Receive by Reference queue block 

27. Address of the Task Control Block (TCB) for the task 
that initiated the Send by Reference 

28. Contents of event flag mask 

29. Address of event flag mask 

30. Pointer to created attachment descriptor 

31. Offset into partition as specified in window 
definition 

32. Length to be mapped 

33. The receiving task's access rights to region being 
mapped 

34. Octal dump of Receive by Reference queue in offset 
mode 



€ 
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RSX-llM CRASH DUHP ANALYZER V3.1 22-SEPT-77 laiie PAGE 17 

ACTIVE TASKS 

niACP© 

© © © 

TCB ADDRESSES ii6060 PAR = FCPPAR PCS AOORESS « 117670 

® ©0 

LOAD ADDRESS « 03130000 LOAD DEVICE » LB0 LBN » 00677200 

© © ® © 

PRl « 149. I/O COUNT » 0, UlC » tl,l] TI s CO0 
MAX SIZE s 000400 EVENT FLAGS e <1-16> 000002 <17>32> 040004 

® ® 

T.STATi© 

T.STgl STP© 

T,8T3J ACP -PMD PRV NSO CAL @ 

000000 000000 00022S 000000 025167 003310 000000 116072 000000') 

000020 116076 000002 040004 063644 071344 000000 000020 150300 1/^ 

000040 001625 077200 063740 117670 000400 067220 064300 064300 | ^ 

000060 000000 000000 000000 116144 000000 116150 000000 000000 J 

RECEIVE QUEUE 



® 

RECEIVE BLOCK ADDRESS ■ : 


124630 


Bi50f1Cli' 80{^k15!!?l , 377876 
0i(!fp4p (^3i'*lg^ (?i1??13H 


0ki0fc»00 
k! .103013 


AST QUEUE 





123456 154521 mill 222222 333333 

?t?a0i<0 Kf!l^00;? ?lk?030? 000000 30000 
0?0?l'S! 



?}® 



(2) @ 

AST BLOCK ADDRESS a 142420 A.CBL s 020012 

(g) © ® 

A, BYT s 000020 A, AST s 174646 A.NPR a 000001 

000000 000000 020012 000020 174646 000001 000124© 



RECEIVE BY REFERENCE QUEUE 

© @ 

RRQ AOORESS s 153644 SENDER TCB = 116330 
© © 

EVENT FLAG ^'ASK s 000001 EVENT FLAG MASK ADOR a 146420 

® 
REGION ID OF RECEIVER = 000006 

@ 
OFFSET IN PARTITION a 000000 

© @ 

LENGTH TO MAP a 003000 ACCESS RIGHTS a 000003 



000001!) ?>00000 116330 000001 146420 000006 000000 003000 
00(9^2i" (lEi0000 000000 000000 000000 (100000 000000 000000 000 



00003 -» (3) 
Figure 3-7 Active Tasks (Truncated) 
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3.2.2 Active Task (MCR) 

The active task listing for ...MCR has more information contained in 
it than the active task listing for other tasks. Figure 3-8 shows an 
example listing. The first seventeen items are the same as Figure 
3-7.. The items in the following list describe only the items that are 
different from the previous figure. 

Item Description 

1. Address of MCR input buffer 

2. Address of Unit Control Block of the requesting 
terminal 

3. Device name and unit number of the terminal that sent 
block to MCR (ASCII characters) 

4. Octal dump in offset mode 

5. Address of command buffer 

6. Address of Unit Control Block of the requesting 
terminal 

7. ASCII dump of command buffer 

8. Octal dump of command buffer in offset mode 



€ 
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RSX-llM CRASH DUMP ANALYZER VJ.i 
ACTIVE TASKS 
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( 



9 • • MC" 

TCB ADDRESS » 115260 PAR a SYSPAR PCB ADDRESS ■ 117734 

LOAD ADDRESS s 0(3120000 LOAD DEVICE > LB0 LBN ■ 00676653 

PRI « 160. I/O COUNT » a, UIC » (1»24] TI « TT2 

MAX SIZE » 00Blk)0 EVENT FLAGS » <1"16> 000001 <17"32> 040000 

T.STATj 

T.ST2J STP 

T,ST3j -PMD PRV CLI NSO CAL 



(H.l(^k"?if' 


i^l<?Jf)it 


Pi1^2'4H 


P'iciMC??? 


13157U 


050712 


100346 


01J0000 


000000 


fn-)(?B2t) 


115276 


0K);?i30i 


0U0000 


0546t'''a 


114760 


(AI?C^e00 


000020 


051300 


k>(1?,0Uf 


ri/'164'? 


"176653 


Pt6374fl 


11773U 


5109100 


116060 


064104 


064104 


1tivU;6'" 


.If 0,1?/ 


£10t^k1(?^ 


Pd«[»?)K 


115344 


fl0000? 


115350 


000000 


000000 



RECEIVE QUEUE 



,_©.. 



HCR INPUT BUFFER ADDRESS a 100346 



TT35J PIP /LI © 



UCB 



© 
3 056352 



00eid00 000000 056352 044520 020120 046507 020111 020040 020040 

ni^0t420 E!i2004i?i n^^aaaa apaaua a^^aaua a^aaua a^asfa^ a?aaaa ayaaaet 

000040 020040 020040 020040 020040 020040 020040 020040 020040 

000060 020040 020040 020040 020040 020040 020040 020040 020040 

000100 020040 020040 020040 020040 020040 020040 020040 020040 



>/7^ 



MCR COMMAND BLOCKS 

©""" 

SUFFER ADDRESS s 103620 

TEXT: PIP /BR© 



TCB 



056352 



000«)00 


000000 


056352 


044520 


020120 


041507 


051040 


020040 


020040 


000020 


020040 


320040 


020040 


020040 


020040 


020040 


020040 


020040 


000040 


020040 


020040 


020040 


020040 


020040 


020040 


020040 


020040 


000060 


020040 


020040 


020040 


020040 


020040 


020040 


020040 


020040 


000 1.;^? 


H20B40 


020040 


020040 


020040 


020040 


020040 


020040 


020040 



Figure 3-8 Active Task (MCR) 
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3.2.3 Task Headers 

Figure 3-9 is an example of a task header listing. The following list 
describes its contents. 



Item Description 

1. Task name 

2. Pointer to the first word in the task header 

3. Pointer to the first word in the Task Control Block 

4. Contents of Processor Status Word and Program Counter 

5. Contents of the general registers 

6. Initial contents of the Processor Status Word, the 
Program Counter and the Stack Pointer 

7. The task header size in decimal bytes, the number of 
windows required to map the task, and the number of 
Logical Unit Numbers assigned to the task 

8. Current and default UIC 

9. Pointer to number of window blocks 

10. Pointer to header and guard word 

11. Work area extension vector pointer 

12. Priority difference for swapping 

13. Directive Status Word 

14. Address of File Control Services (FCS) impure area 

15. Address of FORTRAN impure area 

16. Address of overlay impure storage 

LOGICAL UNIT TABLE 

17. Logical Unit Number 

18. Physical device name before redirect 

19. Window pointer in header 

20. The low-order byte of this word indicates the number 
of map entries active; the high-order byte has the 
following bit assignments: 



c 



€ 



C 



I 



3-14 



( 



c 



ANALYSIS LISTINGS 

WI.RDV=400 - read virtual address allowed if set 
WI.WRV=1000 - write virtual block allowed if set 
WJ. . CiAx— zuuu — exteiiu cij.±uweu j.i. set 
WI.LCK=4000 - set if locked against shared access 
WI,DLK=10000 - set if de-access lock enabled 
WI.BPS=100000 - bypass access interlock if set 

21. High byte of first virtual block number mapped by 
window 

22. Address of File Control Block 

23. File number 

24. File sequence number 

25. File Control Block status word 

26. Number of accesses 

27. Number of block locks 

WINDOW BLOCKS 

28. The name of the partition in thich the task runs 

29. The virtual limits of the task 

30. Address of attachment descriptor 

31. Window size in 32 word blocks 

32. Offset into partition 

33. Address of the first Page Description Register (PDR) 
used to map the window 

34. Number of PDRs used 

35. The contents of the last PDR used 

36. Octal dump of task header in offset mode 
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f 



RMOEMO © 



© 



© 



HEADER ADDRESS ■ 077010 TCB ADDRESS s 070260 

P5«170010 PC«125072© 

R0»131560 Rl»001601 R2»125032 R3»000110 R4»000060 R5«1233S3 8P«120352© 

INITIAL PS ■ 170017 INITIAL PC ■ 121464 INITIAL 8P ■ 120352® 

HEADER SIZE ■ 106. NO. OF WINDOWS > 1. NO. OF LUNS ■ 2.© 



CURRENT UIC » [4,54] DEFAULT UlC ■ t4»54] ® 

© ® ® 

H.WND E 077116 H.GARD ■ 077160 H.VEXT ■ 000000 

@ ® © , 

DSW 1^00001 H.PCS a 000000 H.FORT a 000000 



® 
H.SPRI a -5. 

® 
H.OVLV a 000000 



c 



LOGICAL UNIT TABLEl 










® ® ® ® ® 
# DEV MINOOW W.CTL W.VBN 


® 
W.FCB 


@ 
F.FNUM 


® 
F.FSEQ 


® 
F.STAT 


m »•■ ««a«Mi* «••■« *«««« 










1 TT12 000000 

2 TI0 000000 










WINDOW BLOCKSl 










@ ® ® ® 
PAR VIRT LIMITS ATT DESC WND SIZE 


OFFSET 


® 
1ST PDR 


® 

NO. L 


• «« ••WMOTMMMa* ■»»««i«l«ai» «« 








««*■ * 


GEN 120000 133577 064056 000136 


000000 


212 


1 


HEADER! 










000000 120352 000152 000002 
000020 120352 000000 000000 
000040 000000 000000 077116 
00006^1 000373 000000 000000 
000100 000000 063620 000000 
000120 000136 000000 000612 
000140 125032 000110 000060 


070302 
000000 

000001 
000000 
000001 
056406 
123353 


002054 
000000 

000000 

000000 
067600 
170010 
000000 


002054 
000000 

000000 

077160 
120000 
125072 


170017 
000000 
000000 
000002 
133577 
131560 



@ @ 



056406 



121464 



000000 
055524 
064056 
001601 



.f36l 



I 



€ 



Figure 3-9 Task Headers (Truncated) 



3.2.4 Partition Information 

CDA outputs partition information in two segments. The listing shown 
in Figure 3-10 is a composite of system partition information while 
the listing shown in Figure 3-11 represents individual partition 
information. The following list describes elements of Figure 3-10. 
Attachment Descriptors and Wait Queues are included with individual 
partitions when they apply. 
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Item 

1. 
2. 

3. 
4. 
5. 



Description 



Partition names 



Low and high physical memory addresses for 
partitions 

Size of the partition 

Type of partition 

Task or tasks occupying the partition 



the 
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c 



c 







H E M R 


Y MAP 











© 


© 


1 


© 


© 


PARTITION 


MEMORY ALLOCATED 


SIZE 


TYPE 


OCCUPIED BY 






9(B W 


owl 


• a 




<EXEC» 


eeeeeeee 


00053410 


00053410 








<P00t> 


eeessaie 


00110000 


00034370 








IDR 


00000000 


00000000 


00000000 


MAIN 


TASK 




SYSPAR 


00110000 


00120000 


00010000 


MAIM 


TASK 


■ « 1 MCR 


PCPPAR 


00120000 


00146000 


00026000 


MAIN 


TASK 


FllACP 


DRVPAR 


flaiafcflaa 


00174000 


00026000 


MAIN 


SYS 






00146000 


00155700 


00007700 


SUB 


DRIVER 


TTl 




0015S700 


00160000 


00002100 


sua 


DRIVER 


DBi 




00160000 


00162700 


00002700 


SUB 


DRIVER 


DMJ 




00162700 


00163700 


00001000 


SUB 


DRIVER 


DSt 




00163700 


00165100 


00001200 


SUB 


DRIVER 


DKl 




00165100 


00166200 


00001100 


SUB 


DRIVER 


DT: 




00166200 


00167400 


00001200 


SUB 


DRIVER 


DXi 




00167400 


00170400 


00001000 


SUB 


DRIVER 


LPS 




00170400 


00170500 


00000100 


SUB 


DRIVER 


NLl 




00170500 


00174000 


00003300 


SUB 


DRIVER 


t*m 


GEN 


00174000 


00760000 


00564000 


MAIN 


SYS 






00174000 


00207600 


00013600 


SUB 


TASK 


RMDEMO 




00207600 


00760000 


00550200 


<HOLE> 





Figure 3-10 Partition Information 
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Each item in the following list describes an item in Figure 3-11. 
Item Description 

PARTITION CONTROL BLOCK 

1. Partition name 

2. Pointer to first word of Partition Control Block 

3. Type of partition 

4. Name of main partition 

5. Physical base address of partition in 32. word blocks 

6. Partition size in 32, word blocks 

7. Pointer to the first word of the Task Control Block of 
attached task 

8. Partition protection word (mapped system only) 

9. Priority of attached task 

10. I/O count of attached task 

11. Partition status flags — the 3-letter codes have the 
following meaning: 

OUT - partition is out of memory 

CKP - partition checkpoint in progress 

CKR - partition checkpoint is requested 

-CHK - partition is not checkpointable 

FXD - partition is fixed 

PER - parity error in partition 

LIO - marked by shuffler for long I/O 

NSF - partition cannot be shuffled 

COM - library or common block 

PIC - position independent library or common 

SYS - system controlled partition 

DRV - driver is loaded in partition 

DEL - partition should be deleted when not attached 

APR - starting Active Page Register (APR) number mask 

12. Octal dump of Partition Control Block in offset mode. 
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ATTACHMENT DESCRIPTOR 



Item Description 

13. Address of attachment descriptor 

14. Partition in which attachment occurs 

15. Name of attaching task 

16. Partition Control Block attachment queue thread word 

17. Task Control Block (TCB) attachment queue thread word 

18. Priority of task attached to this partition 

19. I/O count of attached task 

20. The number of times task is mapped through this 
attachment descriptor 

21. Attachment descriptor status byte — the 3-letter 
codes have the following meaning: 

DEL - task has delete access 

EXT - task has extend access 

WRT - task has write access 

RED - task has read access 

22. Octal dump of attachment descriptors in offset mode 

24. Address of Task Control Block for the task 

25. TI: device for the task 

26. Tasks priority 

27. Second status word (state bits) — same as item 15 of 
Figure 3-7 
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© © 
PARTITION PCB AOR 


© 
TYPE 


© 
MAIN 


© 
BASE 


© © 
SIZE P.TCB 


© 
PRO 


© © 
PRI IOC 




• -•• 


>••• 


• -aa 


••-• ••__• 


>•« 


>-•• •_• 


SYSPAR 117754 


MAIN 


SYSPAR 


^^l^^^ 


000100 11S260 


000000 


0. 0. 


P.STATI © 















000000 117670 000000 075273 062072 000000 117734 001200 000100'^ 
000020 000000 117754 100200 115260 000000 100340 000000 064076 > @ 
080040 064076 J 



ATTACHMENT DESCRIPTORSj 



(13) 

ADDRESS 



® 
PARTITION 



064076 SYSPAR 
A.STATi WRT RED© 



(is; 
ATT TASK 

t « « MCR 



© © 

A.PCBL A.TCBL 
000000 000000 



(J8) 

PRI 
160. 



(19) 
IOC 



000000 000000 000240 115260 000000 000003 117734© 



(20) 

MAP COUNT 

0. 



PARTITION PCB AOR TYPE M»IN BASE SIZE P.TCB PRO PRI IOC 
GEN 107560 MAIN GEN 001740 005640 000000 000000 0. 0. 
P.STATi SYS 



€ 



00000? 000000 0000i>0 026226 000000 055254 107560 001740 005640 

000020 06402a 077224 100200 000000 000040 000000 000000 000000 

000040 107616 



MAIT OUEUEl 



(2) 
TASK 



TCB ADR 



(25) 

TI 



(26) 

T.PRI 



STATE BITS (T.ST2) 



...HEL 064024 TT25 150. 

Figure 3-11 Partition Control Blocks and Attachment Descriptors 
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3.2.5 Device Information 

CDA lists information on all devices known to the system. The listing 
in Figure 3-12 shows a typical terminal device listing with an I/O 
packet. The Terminal Status Word (item 15) and Additional Terminal 
Status Word (item 16) will appear only in listings for terminal 
devices. The section labeled I/O Request Packets will appear only for 
devices that have an I/O request in progress or an I/O request 
enqueued at the time of the system crash. The following list 
describes the items in Figure 3-12. 
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Item 
1. 
2, 
3. 
4, 
5. 
6. 

7, 
8. 



10, 



11. 



12. 



ANALYSIS LISTINGS 

Description 

Device name 

Address of first word of Unit Control Block "t'^dv 

Address of first word of Device Control Block (DCB) 

Address of first word of Status Control Block (SCB) 

Pointer to Unit Control Block of redirect unit 

Pointer to Task Control Block (TCB) of Ancillary 
Control Processor (ACP) 

Name of attached task 

Pointer to the Unit Control Block (UCB) of owning 
terminal 

User Identification Code (UIC) used to log onto the 
system 

Unit status byte — the 3-letter codes have the 
following meanings: 

BSY - unit is busy 

MNT - unit is mounted 

FOR - unit is mounted as a foreign volume 

MDM - unit is marked for dismount 

Unit status extension byte — the three letter codes 
have the following meaning: 

OFL - unit offline 

RED - unit redirectable 

PUB - unit is public device 

UMD - unit attached for diagnostics 

Control Processing flags — the 3-letter codes have 
the following meanings: 

ALG - byte alignment allowed 

NPR - device is a NPR device 

QUE - call driver before queuing 

PWF - always call driver at power fail entry point 

ATT - call driver on attach/detach 

KIL - always call driver at I/O kill 

LGH - transfer length mask bits 
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13. First device characteristics word — the 3-letter 
codes have the following meanings: 

REC - record oriented device 

CCL - carriage control device 

TTY - terminal device 

DIR - file structured device 

SDI - single directory device 

SQD - sequential device 

MXD - mass bus device 

UMD - user mode diagnostics supported 

SWL - unit software write locked 

PSE - pseudo device 

COM - device is mountable as COM channel 

Fll - Device is mountable as Fll device 

MNT - device is mountable 

14. Second device characteristics word — the 3-letter 
codes have the following meanings: 

DHl - unit is a DHll multiplexer 

DJl - unit is a DJll multiplexer 

RMT - unit is remote 

L8S - unit is a LA180S 

NEC - solicited input not echoed 

CRT - unit is a CRT 

ESC - unit generates escape sequences 

LOG - user logged on terminal 

SLV - unit is a slave terminal 

DZl - unit is a DZll 

HLD - terminal is in hold screen mode 

AT. - MCR command AT. is being processed 

PRV - unit is privileged terminal 

L3S - unit is a LA30S terminal 

VT5 - unit is a VT05B terminal 

LWC - lower case to upper case conversion 



3-22 



I 



€ 



€ 



I 



( 



€ 



C 



ANALYSIS LISTINGS 

UNIT CONTROL BLOCK 

15. Terminal status word — the codes have the following 
meaning: 

OUT/INP - busy terminal is in output/input mode 

CRTY - carriage control at end of line 

CRJT - carriage return just typed 

EOLS - end of line seen 

UIFP - unsolicited input fork pending 

SOLI - solicited input 

CTLO - output disabled 

RUBP - rubout sequence in progress 

16. Additional terminal status — the codes have the 
following meaning: 

RPRM - current write is the prompt for a 
read-after-prompt QIO 

BTWQ - break-through write is queued 

BTWP - write is breaking through a read 

CCPN - CNTRL C is pending under special circumstances 

BAKS - sending exit hold-screen mode escape sequence 

FKCR - last carriage return was ho divide long line 
into multiple lines for CRT 

ECHO - echo in progress 

XOFF - when read is complete, the terminal driver will 
transmit an XOFF 

UPND - output character buffer DHBUF holds byte 
suppressed by XOFF 

CHAR - multi-echo buffer MBUFR holds an input 
character that has been received but not echoed 

WESC - attached task wants escape sequences 

ESCS - in the middle of an escape sequence 

CCON - CNTRL C AST code is armed 

MCTR - doing CNTRL R from tasks buffer 

NCKP - solicited input request is from a 
noncheckpointable task 

UOFF - output turned off by an XOFF 
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17. Octal dump of Unit Control Block 

DEVICE CONTROL BLOCK 

18. Octal dump of Device Control Block 



STATUS CONTROL BLOCK 

19. Octal dump of Status Control Block 



I/O REQUEST PACKETS 

20, Address of the first word of the I/O packet 
The name of the task requesting I/O 
The priority of the task requesting I/O 
Event flag number used to signal I/O completion 
Logical unit number used by requesting task 



21. 
22. 
23. 
24. 
25. 



26. 
27. 



I/O function codes (for detailed information on the 
legal I/O function codes for each device refer to the 
RSX-llM I/O Drivers Reference Manual ) 

Status of the I/O request - current or queued 

Octal dump of I/O request packet in offset mode 



< 
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TTB© 

© 
UCB ADR 



054300 



© 
DCS ADR 

0S4234 



© 
3CB ADR 

054400 



© 
REDIRECT 



ACP 



© © © 

*TT OWNER UOCIN UIC 



PIPT0 NONE 



[4>54] 



( 



U.STSI BSY (g) 

U.ST2:(n) 

U.CTlI QUE PrtF ATT® 

U.Cwij TTY CCL REC® 

U.CW2I PRV® 



c 



c 



UNIT CONTROL BLOCK: 

STATSi OUT CRTY CRJT EOLS @ 

ATERSt BTwQ BTWP BAKS FKCR ESCS 



054274 002054 000000 054234 

054314 000000 000204 054400 

054334 066020 006401 066020 

054354 025400 000000 000000 

DEVICE CONTROL BLOCKj 

054234 054446 054300 052124 



I03HC3V 



ioioovio vwaw wow t 



STATUS CONTROL BLOCKj 

054400 000000 1454400 000000 
054420 001000 000000 000200 
054440 061132 



[16) 

054300 
000000 
000000 

006200 



000000 
dSSdSS 



122740 
054370 



100070 

004526 
120053 

000000 



000070 



054300 
063302 



000000 000007 000010 

140126 177777 103400 i z;^ 

000000 000000 002054 r y^ 

000000 



120110 161077 000030"!^^ 



WVWO liODSD 



054400 
044131 



002174 
054446 



100030 
000003 



}' 



I/O REQUEST PACKETSi 



PACKET ADR 
103000 



(21) 

REQUESTOR 
P1PT0 



PRI 
50, 



(23) 

EFN 
32. 



(24) 

LUN 
1. 



FUNCTION CODE 
lO.RLB 



STATUS 
CURRENT 



000000 000000 020062 100560 105410 05U300 001000 041640 002736 
000020 140040 000000 000416 146060 000120 000000 000000 000000 >- (27) 
000040 000000 076630 000612 037406 



}' 



Figure 3-12 Device Information and I/O Packet (Truncated) 
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3.2.6 System Task Directory 

CDA scans the System Task Directory and outputs {for each task known 

to the system) the information contained in Figure 3-13. The 

information in this format is identical to the first seventeen items 
described in Figure 3-7 of this manual. 



R8X-11M CRASH DUMP ANALYZER V3, I n-NOV-77 14130 PAGE 71 
SYSTEM TASK DIRECTORY 

1 1 fHCR 

TCB ADDRESS ■ 105230 PAR ■ SYSPAR PCS ADDRESS » 107734 

LOAD ADDRESS > 0011(9000 LOAD DEVICE s LB0 UBN * 00621265 

PRI ■ 160. I/O COUNT = 0. UIC « [1#24] TI » TT27 

MAX SIZE ■ 000100 EVENT FLAGS a <1-16> 000001 <17-32> 040000 

T.STATi 

T,ST2I STP 

T,ST3l -PMO PRV N80 CAL 

000000 000000 000240 000000 131574 050712 C100000 105242 0000(4(9 

000020 105246 000001 040000 052002 104760 000000 000020 ^S^l^f 

000040 001640 021265 053032 107734 000100 1(!5750 054126 >a54i26 

000060 000000 000000 000000 105314 

Figure 3-13 System Task Directory (Truncated) 



3.2.7 Pool Dump 

As shown in the example (Figure 3-14) , CDA prints the system pool in 
octal, RAD50, and ASCII. If a line is repeated more than nine times, 
CDA prints it once and then prints a message indicating the number of 
identical lines. 

The symbols in Figure 3-14 have the following meanings: 

* indicates that the next word is allocated (word is in $CRAVL) 

+ indicates that the next word is allocated in another free list 
($PKAVL) 

NOTE 

$PKAVL is a list containing fixed size 
blocks. The blocks in this list are 
used for fast allocation. The length of 
these blocks is determined by I.LGTH. 

- indicates that the next word is allocated in both $CRAVL and 
$PKAVL; this is an error condition 
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SYSTEM 



D n n I 



* ■ NEXT WORD ALLOCATED FIRST FREE BLOCK (SCRAVL) a 0533«S 

♦ « NEXT rtORO IS IN SPKAVL LIST JPKAVL ■ 055760 
- ■ NEXT WORD IS IN SPKAVL AND ALSO IN SCRAVL 



c 



053410 




041104 




000000 


053464 




000010 


IJXD 




M80 


HliDB 4H 1 


053420 




053464 




000004 * 


053750 


* 


045400 


IMSD 


D 


NBX 


L 114W hM KJ 


053430 


* 


000000 


* 


000033 * 


053354 


* 


000000 


i 


S 


M6L 


il IV » 


053440 


* 


000000 


* 


002000 * 


000000 


• 


001000 


i 


YX 




L2n i 


053450 


* 


060510 


* 


.111352 * 


000000 


* 


000000 


iOVX 


htj 




iiHsj : 


053460 


* 


000002 


* 


060532 


053654 




000044 


J B 


OWB 


NAD 


611 Za>MS t 


053470 




064450 




110473 


000000 




000000 


IP3 


WIS 




i:cu 1 


053500 




000010 




064472 


053654 




000024 


1 H 


P3R 


NAD 


Til M , M ! 


053510 




044446 




000000 


053674 




000014 


IK.F 




NAT 


Lli&I <w 1 


053520 




000000 




000000 


000003 




000000 


I 




C 


U 1 


053530 


* 


000002 




054340 * 


053600 




135544 


t B 


NH2 


N 


/9LU 'X WdjJ 


053540 


* 


010000 




000002 * 


177777 




000407 


jevp 


B 


80 


FMii J 


053550 


* 


000124 




002400 * 


040252 




000401 


1 BD 


2 


JM4 


FQUT *• 1 


053560 


* 


000000 




000030 * 


160000 




000000 


I 


X 


53X 


M 'J 


053570 


* 


000002 




010370 * 


000000 




00000! 


i B 


B.X 
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A 
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* 
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* 
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* 
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* 
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053770 
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JNED 
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* 
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1 
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* 
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000000 * 
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* 
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1 
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* 
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IE02 


L2 


TR 
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* 
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FP 
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Figure 3-14 Pool Dump (Truncated) 
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3.2.8 Task Dump 

CDA scans the active Task List and, provided the task is resident in 
memory, prints all or a portion of the tasks virtual address space. 
The example in Figure 3-15 and the following list illustrate this 
output. 

Item Description 

1. Task name 

2. Address of the first word of the Task Control Block for 
the task 

3. Address of the first word of the task's header 
WINDOW BLOCKS 

4. Name of the partition in which the task resides 

5. Lowest and highest virtual addresses available to the ■ 
task 

6. Address of the attachment descriptor 

7. Size of window in 32. word blocks 

8. Offset to task image within partition in 32. word blocks 

9. First Page Description Register used to map the task 

10. Number of Page Description Registers used to map task M 

11. Contents of the last Page Description Register used to 
map the task 

12. Same as number 5 above 

13. Physical starting address of the task 

14. Dump of the task in octal, RAD50, and ASCII 
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R8X-11M CRASH DUMP ANALYZER 
TASK DUMP 



VJ.l 



15-NOV-77 10(42 



PAGE b 



TASK DUMP OF ,,,MCR 



© 



TCB ADDRESS > 1^523I9 



© 
HEADER ADDRESS s 071530 



c 



MINDOM BLOCKS: 

© © 

PAR VIRT LIMITS 



© © © © ® ® 
ATT DESC WND SIZE OFFSET 1ST PDR NO, LAST POR 



SY8PAR 120000 127777 05aa7a 



000100 000000 177612 



037406 



c 



WINDOW #1 — TASK VIRTUAL LIMITS 120000-127777 (g) 
PHYSICAL STARTING ADDRESS s 110000@ 



120000 


120362 


000162 


100001 


105252 


IY08 


B4 


TSI 


VGRltp 


r • 1 


120010 


000424 


000424 


170017 


120634 


J F6 


F6 


8P0 


Y4Ln 


p 11 


120020 


120362 


000000 


000000 


000000 


1Y08 






Up 


1 


120030 


000000 


000000 


000000 


000000 


I 






ti 


I 


120040 


000000 


000000 
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000001 


1 




RTF 


All 


&a 1 
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000000 


000000 
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000000 


J 




Ytb 


11 


1" I 
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000000 


000000 


000000 


1 FK 






IM 


1 
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000000 
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000004 


052712 


S 


RU 


D 
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Hs JU! 
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000000 


053032 


000000 


053032 


1 
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V VJ 
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000000 
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000000 


000001 


: 


M0V 
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V 1 
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107734 


120000 
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054074 


H , 


YX 


,F0 


ND.IJV 


/<Xl 
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000100 


000000 
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037406 


1 AX 




14 


JCNli* 


?l 
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170000 
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18P 
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000000 
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ZJ 
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Figure 3-15 Task Dump (Truncated) 
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3.2.9 Clock Queue 

The example in Figure 3-16 shows a clock queue listing. The following ^; 
list explains the example. 

Item Description 

1. Address of the clock queue entry 

2. The type of time schedule request 
There are six types: 

Type - mark time request 

Type 2 - request with periodic rescheduling 

Type 4 - single shot task request 

Type 6 - single shot internal system subroutine with 
system subroutine identification 

Type 10- single shot internal system subroutine without 
system subroutine identification 

Type 12- clear stop bit (shuffler) 

3. Task Control Block address or system subroutine 
identification 

4. The hour, minute and second that time request comes due 

5. This field varies with each type of time schedule 
request. There are six types. For a Mark Time request 
the following labels apply: 

CAST - AST address 

C.SRC - event flag mask word 

COST - event flag mask address 

Event Flag Number 

For a request with periodic rescheduling the labels are: 

C.RSI - reschedule internal 

C.UIC - scheduling UIC 

For a single shot task request the field contains only 
one label: 

C.UIC - scheduling UIC 
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For a single shot internal subroutine (both with and 
without system subroutine identification) the field 
contains: 

C.SUB - subroutine address 

CiAR5 - relocation base address (for loadable 
drivers) 



6. Octal dump of clock queue in offset mode 



RSX-llM CRASH DUMP ANALYZER V3.1 29-SEP-77 16J«5 PAGE Ifel 

CLOCK QUEUE 

© © 

ADDRESS a 05232a REQUEST TYPE s 6 TCB a 000003 

TIME REQUEST BECOMES DUE s 5i55j28© 

0C,SUe s 1P7376 CARS s 001600 

00pei?0 053374 000006 000000 051520 000000 127376 001600 000000 
000020 e000C0 052344 040240 001000 000000 160130 064754 000000 



}® 



ADDRESS s 053374 REQUEST TYPg s s TcB s 06373« 

TIME REQUEST BfCOHES DUE = 5l55j32 

CAST » 000000 C.SRC 3 000002 C.DST x 063756 EVENT FLAG c 2. 

diit/i^eid tJ00000 001000 063734 051524 000000 000000 000002 063756 

000020 053600 000010 053523 000004 000000 000062 057704 000000 

Figure 3-16 Clock Queue 
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APPENDIX A 
ERROR MESSAGES 



CDA prints an error message on your terminal when it detects one of 
the error conditions described below. These error messages reflect 
operational conditions. Do not confuse these messages with the 
diagnostic analysis messages that CDA generates during the analysis, 
and prints in the analysis listing. 

Note that not all of the messages listed below result in termination 
of the analysis. Some are informational in nature, while others are 
non-fatal errors. 

CDA — UNKNOWN GET COMMAND LINE ERROR 

Type: Fatal 

Meaning: Unrecognized error has occurred when CDA attempted to 
read a command line. 



CDA — COMMAND I/O ERROR 

^ z ir^ • 

Meaning: The system returned an error when CDA attempted to read 
a command line. 

CDA — INDIRECT FILE OPEN FAILURE 

Type: Fatal. 

Meaning: CDA could not open an indirect command file specified 
as "^filename" in the CDA command line. 

CDA — INDIRECT COMMAND SYNTAX ERROR 
Type: Fatal 

Meaning: The name of the indirect command file (^filename) is 
syntactically incorrect. 

CDA — MAXIMUM INDIRECT FILE DEPTH EXCEEDED 
Type: Fatal 

Meaning: You have exceeded the maximum allowable number of 
nested indirect command files. (Only one level of 
indirection is permitted in CDA.) 
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CDA — FAILED TO EXTEND PAGE BUFFER - n. PAGES AVAILABLE 
Type: Informational 

Meaning: The "extend task" directive failed when CDA attempted 
to use it to expand the page buffer. This problem will 
cause the analysis to take longer, but the analysis 
will continue with a buffer of n pages, each 256 words 
long. 

CDA — FAILED TO ASSIGN LUN TO INPUT DEVICE ddu 

Type: Fatal 

Meaning: The ASSIGN LUN directive failed when CDA attempted to 
use it to attach the specified input device, before 
reading the crash dump from the device. The ASSIGN LUN 
will fail if the device name in the CDA command line is 
invalid. 



c 



CDA — FAILED TO OPEN INPUT FILE filename 
Type: Fatal 
Meaning: One of the following conditions exists: 

1. Specified device does not exist. 

2. The volume is not mounted, 

3. A problem exists with the device. 

4. Specified UFD does not exist. 

5. Specified file does not exist. 

6. You do not have read access privileges. 



CDA — FAILED TO OPEN OUTPUT FILE filename 
Type: Fatal 
Meaning: One of the following conditions exist: 

1. Specified device does not exist. 

2. The volume is not mounted. 

3. A problem exists with the device. 

4. Specified UFD does not exist. 

5. The volume is full or the 
write-pro tec ted. 



device is 



6. You do not have write access privilege to 
UFD. 
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CDA — COMMAND LINE SYNTAX ERROR 
Type: Fatal 

Meaning; CDA detected an error in the syntax of a CDA command 
line. CDA will point to the error within the command 
line. 

CDA — ILLEGAL SWITCH 

Type: Fatal 

Meaning: You have specified an unknown switch or have used a 
legal switch after the wrong file specification. CDA 
will point to the error within the command line. 

CDA — NO OUTPUT FILE SPECIFIED 
Type: Fatal 
Meaning: You have not specified an output file. 

CDA — ANALYSIS OUTPUT MUST BE DIRECTED TO AN EXPLICIT DEVICE OR FILE 
Type: Fatal 

Meaning: CDA requires an explicit output file specification. 
There are no default output file names. 

CDA — OUTPUT DUMP FILENAME MUST BE EXPLICIT 
Type: Fatal 
Meaning: See preceding message. 

CDA — CRASH DUMP MUST BE INPUT FROM AN EXPLICIT DEVICE OR FILE 

Type: Fatal 

Meaning: The crash dump input file specification must be 
explicit. There is no default file specification for 
the crash dump input. 

CDA — NO INPUT FILE SPECIFIED 
Type: Fatal 

Meaning: You did not supply an input file specification for the 
crash dump. 
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CDA — DUMP ABORTED - KERNEL PAR'S CLOBBERED 

Type: Fatal 

Meaning: This message appears on mapped systems only. It 
indicates that the values contained in the PARs are 
invalid. To restart the analysis, you must specify the 
/KMR switch (see Section 2.2.5). This switch forces 
CDA to use standard mapping values when converting 
kernel virtual addresses to physical memory addresses. 



I 



CDA — ERROR WRITING ANALYSIS FILE 

Type: Fatal 

Meaning: The system returned an error when CDA attempted to 
write a line into the analysis listing file. This 
could be caused by: 

1. A problem with the device. 

2. A full volume. 

3. A bad block on the volume. 



CDA — POOL LINK ERROR FOUND - CONTINUING 

Type: Analysis diagnostic 

Meaning: CDA detected a link error while scanning the pool free 
block pointers. This condition can be associated with 
the crash. It can also mean that you specified the 
wrong executive symbol table file. If the latter is 
true, the entire analysis will be meaningless, and you 
should abort CDA. 



CDA — TASK 'taskname' NOT IN MEMORY 
Type: Diagnostic 
Meaning: The above message can be caused by two conditions: 

1. You have requested a dump of a task which 
does not have an entry in the System Task 
Directory or 

2. The task has an entry in the System Task 
Directory, but, it is marked out of memory. 

You can verify the state of the task by examining a 
dump of the Task Control Blocks. 
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CDA — PREMATURE END OF DUMP INPUT - filename BEING ZERO-FILLED 

Type: Informational 

Meaning: CDA reached the end of the medium (or end of file mark, 

if magtape) before the crash dump output file had been 

completely filled. If you expected the file to be 

completely filled by the dump, this condition could 
indicate a problem. 
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CDA — TRANSFER COMPLETE - ddu MAY BE UNLOADED 

Type: Informational 

Meaning: The transfer of the crash dump to the output file is 
finished; you may unload the crash dump device. This 
message occurs only when you have specified a binary 
file in the output of the command string to CDA. 



c 



CDA — ERROR WRITING DUMP FILE filename 

Type : Fatal 

Meaning: The system returned an error when CDA attempted to 
write into the binary output file. This condition 
could be caused by: 

1. A problem with the device 

2. A full volume 

3. A bad block on the volume 



CDA — ERRORS DETECTED: n. 
Type: Informational 
Meaning: CDA has detected n analysis errors during the run, 

CDA — EXITING DUE TO ILLEGAL TRAP - SNAPSHOT DUMP BEING ATTEMPTED 

Type: Fatal 

Meaning: CDA has aborted after detecting an odd address or some 
other type of fault. If PMD is installed in the 
system, the system will generate a snapshot dump. This 
is an indication of a software problem. You should 
include any available dumps when you send SPRs to 
DIGITAL related to this type of failure. 

CDA — SYMBOL FILE filename HAS ILLEGAL FORMAT 
Type: Fatal 

Meaning: The specified executive symbol table file has an 
improper format, probably caused by entry of the wrong 
file name. However, this message could also indicate a 
problem with the device or medium on which the file is 
located. 

CDA — SYMBOL symbolname NOT DEFINED IN SYMBOL FILE 

Type: Fatal 

Meaning: CDA did not find a symbol that it required for the 
analysis in the specified executive symbol table file. 
You have probably entered the wrong filename or have 
mistakenly used the default filename. 
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CDA — DEVICE DRIVER MISSING 

Type: Fatal 

Meaning: You have not loaded the driver for the crash dump input 
device. 

CDA — ERROR READING FILE filename 

Type: Fatal 

Meaning: The system returned an error when CDA attempted to read 
the crash dump file. This could be caused by: 

1. A device error 

2. A bad block on the volume 

CDA — ERROR READING SYMBOL FILE filename 
Type: Fatal 
Meaning: See preceding message. 

CDA ~ ANALYSIS TERMINATED AFTER n, PAGES 

Type: Informational 

Meaning: CDA terminated the analysis after generating n pages of 
analysis output. If the user has not specified the 
/LIMIT switch in the CDA command string, this message 
indicates that CDA has generated more than 300 pages of 
output. 
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APPENDIX B 
SYSTEM DATA STRDCTDRES AND SYMBOLIC DEFINITIONS 



. IIF NDF $$$YDF 



.NLIST 



( 



COPYRIGHT (C) 1974,1976,1977 

DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS. 

THIS SOFTWARE IS FURNISHED UNDER A LICENSE FOR USE ONLY ON A 
SINGLE COMPUTER SYSTEM AND MAY BE COPIED ONLY WITH THE 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE, OR 
ANY OTHER COPIES THEREOF, MAY NOT BE PROVIDED OR OTHERWISE 
MADE AVAILABLE TO ANY OTHER PERSON EXCEPT FOR USE ON SUCH 
SYSTEM AND TO ONE WHO AGREES TO THESE LICENSE TERMS. TITLE 
TO AND OWNERSHIP OF THE SOFTWARE SHALL AT ALL TIMES REMAIN 
IN DEC. 

THE INFORMATION IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT 
NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL 
EQUIPMENT CORPORATION. 

DEC ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF 
ITS SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DEC. 

.MACRO CLKDF$,L,B 



CLOCK QUEUE CONTROL BLOCK OFFSET DEFINITIONS 
CLOCK QUEUE CONTROL BLOCK 

THERE ARE FIVE TYPES OF CLOCK QUEUE CONTROL BLOCKS. EACH CONTROL BLOCK HAS 
THE SAME FORMAT IN THE FIRST FIVE WORDS AND DIFFERS IN THE REMAINING THREE. 

THE FOLLOWING CONTROL BLOCK TYPES ARE DEFINED: 



C.MRKT='B'0 

C.SCHD='B'2 

C.SSHT='B'4 

C.SyST='B'6 

C.SYTK='B'8. 

C.CSTP='B'10. 



;MARK TIME REQUEST 

;TASK REQUEST WITH PERIODIC RESCHEDULING 

; SINGLE SHOT TASK REQUEST 

; SINGLE SHOT INTERNAL SYSTEM SUBROUTINE (IDENT) 

; SINGLE SHOT INTERNAL SYSTEM SUBROUTINE (TASK) 

;CLEAR STOP BIT (CONDITIONALIZED ON SHUFFLING) 



CLOCK QUEUE CONTROL BLOCK TYPE IDEPENDENT OFFSET DEFINITIONS 



.=0 

C.LNK: 
C . RQT : 



•L' 
'L' 



.ASECT 

.BLKW 1 
.BLKB 1 



; CLOCK QUEUE THREAD WORD 
; REQUEST TYPE 
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C.EFN: "L" .BLKB 1 
C.TCB: 'L' .BLKW 1 
C.TIM: 'L' .BLKW 2 



■EVENT FLAG NUMBER (MARK TIME ONLY) 

;TCB ADDRESS OR SYSTEM SUBROUTINE IDENTIFICATION 

; ABSOLUTE TIME WHEN REQUEST COMES DUE 



c 



CLOCK QUEUE CONTROL BLOCK-MARK TIME DEPENDENT OFFSET DEFINITIONS 



.=C.TIM+4 

CAST: 'L' .BLKW 1 

C . SRC : ' L • . BLKW 1 

C.DST: 'L' .BLKW 1 



; START OF DEPENDENT AREA 

;AST ADDRESS 

;FLAG MASK WORD FOR 'BIS' SOURCE 

; ADDRESS OP "BIS" DESTINATION 



CLOCK QUEUE CONTROL BLOCK-PERIODIC RESCHEDULING DEPENDENT OFFSET DEFINITIONS 



.=C.TIM+4 

C.RSI: 'L' .BLKW 2 

C.UIC: 'L' .BLKW 1 



START OF DEPENDENT AREA 
RESCHEDULE INTERVAL IN CLOCK TICKS 
SCHEDULING UIC 



CLOCK QUEUE CONTROL BLOCK-SINGLE SHOT DEPENDENT OFFSET DEFINITIONS 



=C.TIM+4 

. BLKW 2 
. BLKW 1 



START OF DEPENDENT AREA 
TWO UNUSED WORDS 
SCHEDULING UIC 



CLOCK QUEUE CONTROL BLOCK-SINGLE SHOT INTERNAL SUBROUTINE OFFSET DEFINITIONS 

THERE ARE TWO TYPE CODES FOR THIS TYPE OF REQUEST: 'L' 

TYPE 6=SINGLE SHOT INTERNAL SUBROUTINE WITH A 16 BIT VALUE AS AN IDENTIFIER. 
TYPE 8=SINGLE SHOT INTERNAL SUBROUTINE WITH A TCB ADDRESS AS AN IDENTIFIER. 



€ 



.=C.TIM+4 

C.SUB: 'L' .BLKW 1 

CARS: 'L' .BLKW 1 

. BLKW 1 
C.LGTH='B' . 

.PSECT 



; START OF DEPENDENT AREA 

.•SUBROUTINE ADDRESS 

; RELOCATION BASE (FOR LOADABLE DRIVERS) 

;ONE UNUSED WORD 

; LENGTH OF CLOCK QUEUE CONTROL BLOCK 



.MACRO CLKDF? X,Y 

. ENDM 

.ENDM 

.IIF NDF S$$YDF , .LIST 
.IIF NDF S$$YDF , .NLIST 

COPYRIGHT (C) 1974,1976,1977 

DIGITAL EQUIPMENT CORPORATION, MAYNARD , MASS. 

THIS SOFTWARE IS FURNISHED UNDER A LICENSE FOR USE ONLY ON A 
SINGLE COMPUTER SYSTEM AND MAY BE COPIED ONLY WITH THE 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE, OR 
ANY OTHER COPIES THEREOF, MAY NOT BE PROVIDED OR OTHERWISE 
MADE AVAILABLE TO ANY OTHER PERSON EXCEPT FOR USE ON SUCH 
SYSTEM AND TO ONE WHO AGREES TO THESE LICENSE TERMS. TITLE 
TO AND OWNERSHIP OF THE SOFTWARE SHALL AT ALL TIMES REMAIN 
IN DEC. 
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THE INFORMATION IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT 
NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL 
EQUIPMENT CORPORATION. 

DEC ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF 
ITS SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DEC. 



%fci 



.MACRO DCBDF$,L,B 



( 



DEVICE CONTROL BLOCK 

THE DEVICE CONTROL BLOCK (DCB) DEFINES GENERIC INFORMATION ABOUT A DEVICE 
TYPE AND THE LOWEST AND HIGHEST UNIT NUMBERS. THERE IS AT LEAST ONE DCB 
FOR EACH DEVICE TYPE IN A SYSTEM. FOR EXAMPLE, IF THERE ARE TELETYPES IN A 
SYSTEM, THEN THERE IS AT LEAST ONE DCB WITH THE DEVICE NAME 'TT'. IF PART 
OF THE TELETYPES WERE INTERFACED VIA DLll-A'S AND THE REST VIA A DHll, THEN 
THERE WOULD BE TWO DCB ' S . ONE FOR ALL DLll-A INTERFACED TELETYPES, AND ONE 
FOR ALL DHll INTERFACED TELETYPES. 



.ASECT 



.=0 




D.LNK: 


■L" .BLKW 1 


D . UCB : 


■L' .BLKW 1 


D.NAM: 


'L' .BLKW 1 


D.UNIT 


: 'L' .BLKB 1 




. BLKB 1 


D.UCBL 


: 'L' .BLKW 1 


D.DSP: 


'L' .BLKW 1 


D.MSK: 


■L' .BLKW 1 




. BLKW 1 




. BLKW 1 




. BLKW 1 




. BLKW 1 




. BLKW 1 




. BLKW 1 




. BLKW 1 


D.PCB: 


■L' .BLKW 1 



LINK TO NEXT DCB 

POINTER TO FIRST UNIT CONTROL BLOCK 

GENERIC DEVICE NAME 

LOWEST UNIT NUMBER COVERED BY THIS DCB 

HIGHEST UNIT NUMBER COVERED BY THIS DCB 

LENGTH OF EACH UNIT CONTROL BLOCK IN BYTES 

POINTER TO DRIVER DISPATCH TABLE 

LEGAL FUNCTION MASK CODES 0-15. 

CONTROL FUNCTION MASK CODES 0-15. 

NOP 'ED FUNCTION MASK CODES 0-15. 

ACP FUNCTION MASK CODES 0-15. 

LEGAL FUNCTION MASK CODES 16.-31. 

CONTROL FUNCTION MASK CODES 16.-31. 

NOP 'ED FUNCTION MASK CODES 16.-31. 

ACP FUNCTION mask COnES 16r-31. 

LOADABLE DRIVER PCB ADDRESS 



.PSECT 



; + 



DRIVER DISPATCH TABLE OFFSET DEFINITIONS 



D.VINI='B'0 
D.VCAN='B'2 
D.V0UT='B'4 
D.VPWF='B'6 



;DEVICE INITIATOR 

; CANCEL CURRENT I/O FUNCTION 

; DEVICE TIMEOUT 

;POWERFAIL RECOVERY 



.MACRO DCBDF$,X,Y 

.ENDM 

.ENDM 



.IIF NDF S$$YDF , .LIST 

.IIF NDF,S$$YDF, .NLIST 

.TITLE FllTBL FILES 11 TABLE DEFINITIONS 

.IDENT /0018/ 

COPYRIGHT (C) 1973,1976,1977 

DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS. 
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THIS SOFTWARE IS FURNISHED UNDER A LICENSE FOR USE ONLY ON A 
SINGLE COMPUTER SYSTEM AND MAY BE COPIED ONLY WITH THE 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE, OR 
ANY OTHER COPIES THEREOF, MAY NOT BE PROVIDED OR OTHERWISE 
MADE AVAILABLE TO ANY OTHER PERSON EXCEPT FOR USE ON SUCH 
SYSTEM AND TO ONE WHO AGREES TO THESE LICENSE TERMS. TITLE 
TO AND OWNERSHIP OF THE SOFTWARE SHALL AT ALL TIMES REMAIN 
IN DEC. 

THE INFORMATION IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT 
NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL 
EQUIPMENT CORPORATION. 

DEC ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF 
ITS SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DEC. 

ANDREW C. GOLDSTEIN 30 OCT 75 17:55 
PETER H. LIPMAN 12/27/73 





. MACRO 


F11DF$ 


; VOLUME CONTROL BLOCK 




.ASECT 




.=0 






V.TRCT 


: . BLKW 


1 


V.IFWI 


: . BLKW 


1 




.IF 


DF,R$$11D 


V.STD: 


.BLKW 
-ENDC 


1 


V.FCB: 


.BLKW 


2 


V.IBLB 


: .BLKB 


1 


V.IBSZ 


: .BLKB 


1 




.BLKW 


1 


V.FMAX 


: .BLKW 


1 


V.WISZ 


: . BLKB 


1 


V.SBCL 


.BLKB 


1 


V.SBSZ 


.BLKW 


1 


V.SBLB 


.BLKB 


1 


V.FIEX 


.BLKB 


1 




.BLKW 


1 




.IF 


DF,R$$11M 


V.VOWN 


.BLKW 


1 


V.VPRO 


.BLKW 


1 


V.VCHA 


.BLKW 
• IFTF 


1 


V.FPRO 


.BLKW 
.IFT 


1 


V.VFSQ. 


.BLKW 
.IFF • 


1 




.BLKW 


1 




.ENDC 




V.FRBK: 


.BLKB 


1 


V.LRUC: 


.BLKB 


1 




.BLKW 


1 




.IF 


DF,R$$11D 


V.LABL: 


.BLKB 
.ENDC 


12. 


V.STAT: 


• BLKB 


1 




VC.IFW= 


1 




VC . BMW= 


2 


V.PFNU: 


.BLKB 


1 



f 



; TRANSACTION COUNT 
; INDEX FILE WINDOW 

;STD OF TASK CHARGED WITH NODE 

;FILE CONTROL BLOCK LIST HEAD 

; INDEX BIT MAP 1ST LBN HIGH BYTE 

; INDEX BIT MAP SIZE IN BLOCKS 

; INDEX BIT MAP 1ST LBN LOW BITS 

;MAX NO. OF FILES ON VOLUME 

;DFLT SIZE OF WINDOW IN NO. OF RTRV PTRS 

; VALUE IS < 128. 

; STORAGE BIT MAP CLUSTER FACTOR 

; STORAGE BIT MAP SIZE IN BLOCKS 

; STORAGE BIT MAP 1ST LBN HIGH BYTE 

.•DEFAULT FILE EXTEND SIZE 

; STORAGE BIT MAP 1ST LBN LOW BITS 

; VOLUME OWVER'S UIC 
; VOLUME PROTECTION 
;VOLUME CHARACTERISTICS 

; VOLUME DEFAULT FILE PROTECTION 

;VOLUME FILE SEQUENCE NUMBER 

;NOT USED 

.-NUMBER OF FREE BLOCKS ON VOLUME HIGH BYTE 
; COUNT OF AVAILABLE LRU SLOTS IN FCB LIST 
.-NUMBER OF FREE BLOCKS ON VOLUME LOW BITS 

;VOLUME LABEL (ASCII) 

; VOLUME STATUS BYTE, CONTAINING THE FOLLOWING 

; INDEX FILE IS WRITE ACCESSED 

; STORAGE BITMAP FILE IS WRITE ACCESSED 

; FIRST FREE INDEX FILE BITMAP BLOCK 



€ 
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( 



V.LGTH: 



; FILE CONTROL BLOCK 



;SIZE IN BYTES OP VCB 



c 



c 





.ASECT 




.=0 






F.LINK: 


.BLKW 


1 




.IF 


DF,R$$11D 


F.FEXTs 


.BLKW 


1 


F.STD: 


.BLKW 
.ENDC 


1 


F.FNUM: 


.BLKW 


1 


F.FSEQ: 


.BLKW 


1 


F.RVN: 


.BLKB 


1 


F.FSQN: 


.BLKB 


1 


F . FOWN : 


.BLKW 


1 


F.FPRO: 


.BLKW 


1 


F.UCHA: 


.BLKB 


1 


F.SCHA: 


.BLKB 


1 


P.HDLB: 


.BLKW 


2 


F . LBN : 


• BLKW 


2 


F.SIZE: 


.BLKW 


2 


F.NACS: 


.BLKB 


1 


F.NLCK: 


.BLKB 


1 




S.STBK= 


=.-F.LBN 


F.STAT: 






F.NWAC: 


.BLKB 


1 




.BLKB 


1 




FC.WAC= 


=100000 




FC.DIR= 


=40000 




FC.CEF= 


=20000 




FC.FCO= 


=10000 


F.DREF: 


.BLKW 


1 


F.DRNM: 


.BLKW 


1 




.IF 


DF,R$$11M 


F.FEXT: 


. RT.KW 
.ENDC 


1 


F . FVBN : 


.BLKW 


2 


F.LKL: 


• BLKW 


1 


F . LGTH : 






; WINDOW 






.ASECT 




.=0 






W.CTL: 


.BLKW 


1 




WI.RDV= 


=400 




WI.WRV= 


=1000 




WI,EXT= 


=2000 




WI.LCK= 


=4000 




WI.DLK= 


=10000 




WI.EXL= 


=40000 




WI.BPS= 


=100000 




.IF 


DF,R?$11M 


W.VBN: 


.BLKB 


1 


W.WISZ: 


.BLKB 


1 




.BLKW 


1 


W.FCB: 


.BLKW 


1 



;FCB CHAIN POINTER 

; POINTER TO EXTENSION FCE 
;STD OF TASK CHARGED WITH NODE 

FILE NUMBER 

FILE SEQUENCE NUMBER 

RELATIVE VOLUME NUMBER OF FILE 

FILE SEGMENT NUMBER 

FILE OWNER'S UIC 

FILE PROTECTION CODE 

USER CONTROLLED CHARACTERISTICS 

SYSTEM CONTROLLED CHARACTERISTICS 

FILE HEADER LOGICAL BLOCK NUMBER 

BEGINNING OF STATISTICS BLOCK 

LBN OF VIRTUAL BLOCK 1 IF CONTIGUOUS 

IF NON CONTIGUOUS 

SIZE OF FILE IN BLOCKS 

NO. OF ACCESSES 

NO. OF LOCKS 

SIZE OF STATICS BLOCK 

FCB STATUS WORD 

;NUMBER OF WRITE ACCESSORS 

; STATUS BITS FOR FCB CONSISTING OF 

;SET IF FILE ACCESSED FOR WRITE 

;SET IF FCB IS IN DIRECTORY LRU 

;SET IF DIRECTORY EOF NEEDS UPDATING 

;SET IF TRYING TO FORCE DIRECTORY CONTIG 

;DIRECTORY EOF BLOCK NUMBER 

;1ST WORD OF DIRECTORY NAME 

jPOTNTRR to EXTRNSTON VCR 

; STARTING VBN OF THIS FILE SEGMENT 

; POINTER TO LOCKED BLOCK LIST FOR FILE 

;SIZE IN BYTES OF FCB 



;LOW BYTE = # OF MAP ENTRIES ACTIVE 

;HIGH BYTE CONSISTS OF THE FOLLOWING BITS 

;READ VIRTUAL BLOCK ALLOWED IF SET 

;WRITE VIRTUAL BLOCK ALLOWED IF SET 

; EXTEND ALLOWED IF SET 

;SET IF LOCKED AGAINST SHARED ACCESS 

;SET IF DEACCESS LOCK ENABLED 

;SET IF MANUAL UNLOCK DESIRED 

; BYPASS ACCESS INTERLOCK IF SET 

;HIGH BYTE OF 1ST VBN MAPPED BY WINDOW 
;SIZE IN RTRV PTRS OF WINDOW (7 BITS) 
;LOW ORDER WORD OF 1ST VBN MAPPED 
;FILE CONTROL BLOCK ADDRESS 
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.ENDC 






.IF 


DF,R$$11D 


W.FCB: 


.BLKW 


1 


W.STD: 


.BLKW 


1 


W.VBN: 


.BLKB 


1 


W.WISZ: 


.BLKB 


1 




.BLKW 


1 




.ENDC 




W.RTRV: 







;FILE CONTROL BLOCK ADDRESS 
;STD OF TASK CHARGED WITH WINDOW NODE 
;HIGH BYTE OF 1ST VBN MAPPED BY WINDOW 
;SIZE IN RTRV PTRS OF WINDOW (7 BITS) 
;LOW ORDER WORD OF 1ST VBN MAPPED 

;OFFSET TO 1ST RETRIEVAL POINTER IN WINDOW 



I 



LOCKED BLOCK LIST NODE 



.ASECT 



.=0 






L.LNK 


• BLKW 


1 


L.WIl 


.BLKW 


1 




.IF 


DF,R$$11D 


L.STD 


. BLKW 


1 


L.VBl 


.BLKW 


2 


L.VB2 


.BLKW 


2 


L.CNT 


.BLKB 


1 




.BLKB 


1 




.IFF 




L.VBl 


.BLKB 


1 


L.CNT 


.BLKB 


1 




.BLKW 


1 




.ENDC 




L.LGTI 


i: 

•PSECT 






. MACRO 


FllDF$ 




.ENDM 


F11DF$ 




.ENDM 


F11DF$ 




.IIP 


NDF, S$$YDF,. LIST 




.IIF NDF S$$YDF , .NLIST 



;LINK TO NEXT NODE IN LIST 

; POINTER TO WINDOW FOR FIRST ENTRY 

; POINTER TO STD OF TASK NODE CHARGED TO 
; STARTING VBN OF FIRST ENTRY 
; STARTING VBN OF SECOND ENTRY 
;COUNT FOR FIRST ENTRY 
; COUNT FOR SECOND ENTRY 

;HIGH ORDER VBN BYTE 
•COUNT FOR ENTRY 



c 



COPYRIGHT (C) 1974,1976,1977 

DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS. 

THIS SOFTWARE IS FURNISHED UNDER A LICENSE FOR USE ONLY ON A 
SINGLE COMPUTER SYSTEM AND MAY BE COPIED ONLY WITH THE 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE, OR 
ANY OTHER COPIES THEREOF, MAY NOT BE PROVIDED OR OTHERWISE 
MADE AVAILABLE TO ANY OTHER PERSON EXCEPT FOR USE ON SUCH 
SYSTEM AND TO ONE WHO AGREES TO THESE LICENSE TERMS. TITLE 
TO AND OWNERSHIP OF THE SOFTWARE SHALL AT ALL TIMES REMAIN 
IN DEC. 

THE INFORMATION IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT 
NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL 
EQUIPMENT CORPORATION. 

DEC ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF 
ITS SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DEC. 



.MACRO HDRDF$,L,B 



I 



TASK HEADER OFFSET DEFINITIONS 



.ASECT 
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( 



( 



.=0 

H.CSP: 

H.HDLN 

H.EFLM 

H.CUIC 

H.DUIC 

H.IPS: 

H.IPC: 

H.ISP: 

H.ODVA 

H.ODVL 

H.TKVA 

H.TKVL 

H . PFVA 

H.FPVA 

H.RCVA 

H.EPSV 

H . FPSA 

H.WND: 

H.DSW: 

H . FCS : 

H.FORT 

H.OVLY 

H.VEXT 

H.SPRI 

H.NML: 

H.RRVA 

H.GARD 
H.NLUN 
H.LUN: 



•L" .BLKW 
: 'L' .BLKW 
: 'L' .BLKW 
: 'L' .BLKW 
: 'L' .BLKW 
'L' .BLKW 
'L' .BLKW 
'L' .BLKW 

■L' .BLKW 
: 'L' .BLKW 
: 'l'^.BLKW 
: 'L' .BLKW 

■L' .BLKW 

■L' .BLKW 
: 'L' .BLKW 
: 'L' .BLKW 
: 'L' .BLKW 
'L'.BLKW 
'L' .BLKW 
'L' .BLKW- 
: 'L' .BLKW 
: 'L' .BLKW 
: 'L' .BLKW 
: "L" .BLKB 
'L' .BLKB 
• 'L' .BLKW 

.BLKW 

: 'L' .BLKW 

: 'L' .BLKW 

L' .BLKW 



CURRENT STACK POINTER 

HEADER LENGTH IN BYTES 

EVENT FLAG MASK WORD AND ADDRESS 

CURRENT TASK UIC 

DEFAULT TASK UIC 

INITIAL PROCESSOR STATUS WORD (PS) 

INITIAL PROGRAM COUNTER (PC) 

INITIAL STACK POINTER (SP) 

ODT SST VECTOR ADDRESS 

ODT SST VECTOR LENGTH 

TASK SST VECTOR ADDRESS 

TASK SST VECTOR LENGTH 

POWER FAIL AST CONTROL BLOCK ADDRESS 

FLOATING POINT AST CONTROL BLOCK ADDRESS 

RECEIVE AST CONTROL BLOCK ADDRESS 

EVENT FLAG ADDRESS SAVE ADDRESS 

POINTER TO FLOATING POlNT/EAE SAVE AREA 

POINTER TO NUMBER OF WINDOW BLOCKS 

TASK DIRECTIVE STATUS WORD 

FCS IMPURE POINTER 

FORTRAN IMPURE POINTER 

OVERLAY IMPURE POINTER 

WORK AREA EXTENSION VECTOR POINTER 

PRIORITY DIFFERENCE FOR SWAPPING 

NETWORK MAILBOX LUN 

RECEIVE BY REFERENCE AST CONTROL BLOCK ADDRESS 

RESERVED WORDS 

POINTER TO HEADER GUARD WORD 

NUMBER OF LUN ' S 

START OF LOGICAL UNIT TABLE 



( 



WINDOW BLOCK OFFSETS 



.=0 

W.BPCB 

W.BLVR 

W.BHVR 

W.BATT 

W.BSIZ 

W.BOFF 

W.BFPD 

W.BNPD 

W.BLPD 

W.BLGH 



■ L ' . BLKW 
' L ' . BLKW 
'L' .BLKW 
•L'.BLKW 
'L' .BLKW 
'L' .BLKW 
'L'.BLKB 
'L' .BLKB 
'L' .BLKW 
'L' 
.PSECT 



; PARTITION CONTROL BLOCK ADDRESS 

;LOW VIRTUAL ADDRESS LIMIT 

;HIGH VIRTUAL ADDRESS LIMIT 

.-ADDRESS OF ATTACHMENT DESCRIPTOR 

;SIZE OF WINDOW IN 32W BLOCKS 

; PHYSICAL MEMORY OFFSET IN 32W BLOCKS 

; FIRST PDR ADDRESS' 

; NUMBER OF PDR'S TO MAP 

; CONTENTS OF LAST PDR 

; LENGTH OF WINDOW DESCRIPTOR 



.MACRO HDRDF$ X,Y 
. ENDM 
. ENDM 

.IIF NDF SS$YDF , .LIST 
.IIF NDF S$$YDF , .NLIST 



COPYRIGHT (C) 1974,1976,1977 

DIGITAL EQUIPMENT CORPORATION, MAYNARD , MASS. 

THIS SOFTWARE IS FURNISHED UNDER A LICENSE FOR USE ONLY ON A 
SINGLE COMPUTER SYSTEM AND MAY BE COPIED ONLY WITH THE 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE, OR 
ANY OTHER COPIES THEREOF, MAY NOT BE PROVIDED OR OTHERWISE 
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MADE AVAILABLE TO ANY OTHER PERSON EXCEPT FOR USE ON SUCH 
SYSTEM AND TO ONE WHO AGREES TO THESE LICENSE TERMS. TITLE 
TO AND OWNERSHIP OF THE SOFTWARE SHALL AT ALL TIMES REMAIN 
IN DEC. 

THE INFORMATION IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT 
NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL 
EQUIPMENT CORPORATION. 

DEC ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF 
ITS SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DEC. 



.MACRO HWDDF$,L,B 



; + 



HARDWARE REGISTER ADDRESSES AND STATUS CODES 



MPCSR= ' 
MPAR= ' B 
PIRQ='B 
PRO='B' 
PR1='B' 
PR4='B' 
PR5='B' 
PR6='B' 
PR7='B' 
PS='B'l 
SWR= ■ B ' 
TPS='B' 



B'177746 

■172100 

•177772 



40 

200 

240 

300 

340 

77776 

177570 

177564 



ADDRESS OF PDP-11/70 MEMORY PARITY REGISTER 

ADDRESS OF FIRST MEMORY PARITY REGISTER 

PROGRAMMED INTERRUPT REQUEST REGISTER 

PROCESSOR PRIORITY 

PROCESSOR PRIORITY 1 

PROCESSOR PRIORITY 4 

PROCESSOR PRIORITY 5 

PROCESSOR PRIORITY 6 

PROCESSOR PRIORITY 7 

PROCESSOR STATUS WORD 

CONSOLE SWITCH AND DISPLAY REGISTER 

CONSOLE TERMINAL PRINTER STATUS REGISTER 



EXTENDED ARITHMETIC ELEMENT REGISTERS 



.IF DF E$$EAE 



< 



AC='B'177302 
MQ='B'177304 
SC='B'177310 



; ACCUMULATOR 

; MULTIPLIER-QUOTIENT 

; SHIFT COUNT 



.ENDC 



MEMORY MANAGEMENT HARDWARE REGISTERS AND STATUS CODES 



.IF DF M$$MGE 



I 



KDSARO= 
KDSDRO= 
KISARO= 
KISAR5= 
KISAR6= 
KISAR7= 
KISDRO= 
KISDR6= 
KISDR7= 
SISDRO= 



'B'172360 
■B'172320 
'B"172340 
'B'172352 
'B'172354 
•B'172356 
■B'172300 
'B'172314 
■B'172316 
'B'172200 



KERNEL 


D 


PAR 





KERNEL 


D 


PDR 





KERNEL 


I 


PAR 





KERNEL 


I 


PAR 


5 


KERNEL 


I 


PAR 


6 


KERNEL 


I 


PAR 


7 


KERNEL 


I 


PDR 





KERNEL 


I 


PDR 


6 


KERNEL 


I 


PAR 


7 



SUPERVISOR I PDR 



UDSARO='B' 177660 



;USER D PAR 



I 
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( 



UDSDRO= 
UISARO= 
UISAR4= 
UISAR5= 
UISAR6= 
UISAR7= 
UISDRO= 
UISDR4= 
UISDR5= 
UISDR6= 
0ISDR7= 
UBMPR= ' 
CMODE= ' 
PMODE= ' 
SRO='B' 
SR3='B' 



■B'177620 

'B'177640 

■B'177650 

'B'177652 

'B'177654 

'B'177656 

•B'177600 

•B'177610 

'B'177612 

■B'177614 

■B'177616 

B"170200 

B'140000 

B'30000 

177572 

172516 



USER 


D 


PDR 





USER 


I 


PAR 





USER 


I 


PAR 


4 


USER 


I 


PAR 


5 


USER 


I 


PAR 


6 


USER 


I 


PAR 


7 


USER 


I 


PDR 





USER 


I 


PDR 


4 


USER 


I 


PDR 


5 


USER 


I 


PDR 


6 


USER 


I 


PDR 


7 



UNIBUS MAPPING REGISTER 
CURRENT MODE FIELD OF PS WORD 
PREVIOUS MODE FIELD OF PS WORD 
SEGMENT STATUS REGISTER 
SEGMENT STATUS REGISTER 3 



,ENDC 



; + 



( 



c 



FEATURE SYMBOL DEFINITIONS 



FE.EXT='B'l 

FE.MUP='B'2 

FE.EXV='B'4 

FE.DRV='B'10 

FE.PLA='B'20 

FE.CAL='B'40 

FE.PKT='B'100 

FE.EXP='B'200 

FE.LSI='B'400 

FE.CEX='B'20000 

FE.MXT='B'40000 

FE.NLG='B'100000 



.MACRO HWDDF$ 
• ENDM 

RNOM 



X,Y 



; 11/70 EXTENDED MEMORY SUPPORT 

;MULTI-USER PROTECTION SUPPORT 

;EXECUTIVE IS SUPPORTED TO 20K 

; LOADABLE DRIVER SUPPORT 

;PLAS SUPPORT 

; DYNAMIC CHECKPOINT SPACE ALLOCATION 

;PREALLOCATION OF I/O PACKETS 

; EXTEND TASK DIRECTIVE SUPPORTED 

;PROCESSOR IS AN LSI-11 

;COM EXEC IS LOADED 

;MCR EXIT AFTER EACH COMMAND MODE ■ 

; LOGINS DISABLED - MULTI-USER SUPPORT 



.IIF NDF S$$yDF , .LIST 
.IIF NDF S$$YDF , .NLIST 

COPYRIGHT (C) 1974,1976,1977 

DIGITAL EQUIPMENT CORPORATION, MAYNARD , 



MASS. 



THIS SOFTWARE IS FURNISHED UNDER A LICENSE FOR USE ONLY ON A 
SINGLE COMPUTER SYSTEM AND MAY BE COPIED ONLY WITH THE 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE, OR 
ANY OTHER COPIES THEREOF, MAY NOT BE PROVIDED OR OTHERWISE 
MADE AVAILABLE TO ANY OTHER PERSON EXCEPT FOR USE ON SUCH 
SYSTEM AND TO ONE WHO AGREES TO THESE LICENSE TERMS. TITLE 
TO AND OWNERSHIP OF THE SOFTWARE SHALL AT ALL TIMES REMAIN 
IN DEC. 

THE INFORMATION IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT 
NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL 
EQUIPMENT CORPORATION. 

DEC ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF 
ITS SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DEC. 
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•MACRO LCBDF$,L,B 

LOGICAL ASSIGNMENT CONTROL BLOCK 

THE LOGICAL ASSIGNMENT CONTROL BLOCK (LCB) IS USED TO ASSOCIATE A 
LOGICAL NAME WITH A PHYSICAL DEVICE UNIT. LCB ' S ARE LINKED TOGETHER 
TO FORM THE LOGICAL ASSIGNMENTS OF A SYSTEM. ASSIGNMENTS MAY BE ON 
A SYSTEM WIDE OR LOCAL (TERMINAL) BASIS. 



f 



.ASECT 
.=0 

L.LNK: 'L' 
L.NAM: 'L' 
L.UNIT: 'L' 
L.TYPE: 'L' 
L.UCB: 'L' 
L.ASG: 'L' 
L.LGTH="B' 



•BLKW 1 
.BLKW 1 
.BLKB 1 
.BLKB 1 
•BLKW 1 
.BLKW 1 
.-L.LNK 



.PSECT 



;LINK TO NEXT LCB 

; LOGICAL NAME OF DEVICE 

.•LOGICAL UNIT NUMBER 

;TYPE OF ENTRY (0=SYSTEM WIDE) 

;TI UCB ADDRESS 

; ASSIGNMENT UCB ADDRESS 

; LENGTH OF LCB 



.MACRO LCBDF$,X,Y 

.ENDM 

.ENDM 

.IIF NDF S$$YDF , .LIST 

.IIF NDF S$$YDF , .NLIST 



COPYRIGHT (C) 1974,1976,1977 

DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS. 

THIS SOFTWARE IS FURNISHED UNDER A LICENSE FOR USE ONLY ON A 
SINGLE COMPUTER SYSTEM AND MAY BE COPIED ONLY WITH THE 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE, OR 
ANY OTHER COPIES THEREOF, MAY NOT BE PROVIDED OR OTHERWISE 
MADE AVAILABLE TO ANY OTHER PERSON EXCEPT FOR USE ON SUCH 
SYSTEM AND TO ONE WHO AGREES TO THESE LICENSE TERMS. TITLE 
TO AND OWNERSHIP OF THE SOFTWARE SHALL AT ALL TIMES REMAIN 
IN DEC. 

THE INFORMATION IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT 
NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL 
EQUIPMENT CORPORATION. 

DEC ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF 
ITS SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DEC. 



.MACRO PCBDF$ L,B,SYSDEF 



PARTITION CONTROL BLOCK OFFSET DEFINITIONS 



.ASECT 



.=0 






P.LNK: 


' L * . BLKW 


1 


P.PRI: 


■L' .BLKB 


1 


P. IOC: 


'L' .BLKB 


1 


P.NAM: 


' L ' . BLKW 


2 


P. SUB: 


' L ' . BLKW 


1 


P. MAIN 


: • L • . BLKW 


1 



;LINK TO NEXT PARTITION PCB 

; PRIORITY OF PARTITION 

;I/0 + I/O STATUS BLOCK COUNT 

; PARTITION NAME IN RAD50 

; POINTER TO NEXT SUBPARTITION 

; POINTER TO MAIN PARTITION 
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( 



( 



( 



.IF NB SYSDEF 
•IF NDF M$$MGE 



P.HDR: 'L' 



.ENDC 



.IFTF 



P.REL: 'L' .BLKW 
P. ELKS: 'L' 



P. SIZE: "L 


.BLKW 


1 


P. WAIT: 'L 


.BLKW 


1 


P.SWSZ: 'L 


.BLKW 


1 


P. BUSY: 'L' 


.BLKB 


2 


P. OWN: 'L' 






P.TCB: 'L'. 


BLKW 


1 


P.STAT: "L" 


.BLKW 


1 



; POINTER TO HEADER CONTROL BLOCK 



; STARTING PHYSICAL ADDRESS OF PARTITION 

;SIZE OF PARTITION IN BYTES 

; PARTITION WAIT QUEUE LISTHEAD (2 WORDS) 

.•PARTITION SWAP SIZE (SYSTEM ONLY) 

; PARTITION BUSY FLAGS 

;TCB ADDRESS OF OWNER TASK 
; PARTITION STATUS FLAGS 



.IFT 

.IF DF M$$MGE 

P.HDR: 'L' .BLKW 1 

.ENDC 

P. PRO: 'L' .BLKW 1 
P. ATT: 'L' .BLKW 2 

.IF NDF P$$LAS 
P.LGTH='B'P.PRO 

.IFF 
P . LGTH= ■ B ' . 

. ENDC 

.IFF 

.PSECT 



; POINTER TO HEADER CONTROL BLOCK 



; PROTECTION WORD [DEWR,DEWR,DEWR,DEWR] 
; ATTACHMENT DESCRIPTOR LISTHEAD 



; LENGTH OF PARTITION CONTROL BLOCK 



; LENGTH OF PARTITION CONTROL BLOCK 



; + 



PARTITION STATUS WORD BIT DEFINITIONS 



PS.OUT^ 
PS.CKP^ 
PS.CKR= 
PS.CHK^ 
PS.FXD^ 
PS . PER^ 
PS.LIO^ 
PS.NSF^ 
PS . COM^ 
PS. PIC' 
PS. SYS' 
PS . DRV' 
PS . DEL' 



='B'100000 

='B'40000 

='B'20000 

='B'10000 

='B'4000 

='B'2000 

='B'1000 

='B'400 

='B'200 

='B'100 

='B'40 

="B'20 

='B'10 



PARTITION IS OUT OF MEMORY (1=YES) 

PARTITION CHECKPOINT IN PROGRESS (l'=YES) 

PARTITION CHECKPOINT IS REQUESTED (1=YES) 

PARTITION IS NOT CHECKPOINTABLE (1=YES) 

PARTITION IS FIXED (1=YES) 

PARITY ERROR IN PARTITION (1=YES) 

MARKED BY SHUFFLER FOR LONG I/O (1=YES) 

PARITION IS NOT SHUFFLEABLE (1=YES) 

LIBRARY OR COMMON BLOCK (1=YES) 

POSITION INDEPENDENT LIBRARY OR COMMON (1=YES) 

SYSTEM CONTROLLED PARTITION {1=YES) 

DRIVER IS LOADED IN PARTITION (1=YES) 

PARTITION SHOULD BE DELETED WHEN NOT ATTACHED (l=yES) 



B-11 
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PS.APR='B'7 

+ 
ATTACHMENT DESCRIPTOR OFFSETS 



; STARTING APR NUMBER MASK 



c 



.ASECT 
.=0 

A.PCBL: 'L' .BLKW 1 
A.PRI: 'L' .BLKB 1 
A.IOC: "L" ,BLKB 1 
A.TCB: 'L' .BLKW 1 
A.TCBL: 'L' .BLKW 1 
A.STAT: 'L' .BLKB 1 
A.MPCT: 'L' .BLKB 1 
A.PCB: 'L' .BLKW 1 
A.LGTH='B' . 



;PCB ATTACHMENT QUEUE THREAD WORD 

; PRIORITY OF ATTACHED TASK 

;I/0 COUNT THROUGH THIS DESCRIPTOR 

;TCB ADDRESS OF ATTACHED TASK 

;TCB ATTACHMENT QUEUE THREAD WORD 

; STATUS BYTE 

;MAPPING COUNT OF TASK THRU THIS DESCRIPTOR 

;PCB ADDRESS OF ATTACHED TASK 

; LENGTH OF ATTACHMENT DESCRIPTOR 



ATTACHMENT DESCRIPTOR STATUS BYTE BIT DEFINITIONS 



.PSECT 
AS.DEL='B'10 
AS.EXT='B'4 
AS.WRT='B'2 
AS.RED='B'l 

.ENDC 



;TASK HAS DELETE ACCESS (1=YES) 

;TASK HAS EXTEND ACCESS (l=yES) 

?TASK HAS WRITE ACCESS (1=YES) 

;TASK HAS READ ACCESS (1=YES) 



€ 



.MACRO PCBDF$ X,y,Z 

.ENDM 

. ENDM 

.IIF NDF S$$YDF , .LIST 

.IIF NDF S$$YDF , .NLIST 

COPYRIGHT (C) 1974,1976,1977 

DIGITAL EQUIPMENT CORPORATION, MAYNARD , MASS. 

THIS SOFTWARE IS FURNISHED UNDER A LICENSE FOR USE ONLY ON A 
SINGLE COMPUTER SYSTEM AND MAY BE COPIED ONLY WITH THE 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE, OR 
ANY OTHER COPIES THEREOF, HAY NOT BE PROVIDED OR OTHERWISE 
MADE AVAILABLE TO ANY OTHER PERSON EXCEPT FOR USE ON SUCH 
SYSTEM AND TO ONE WHO AGREES TO THESE LICENSE TERMS. TITLE 
TO AND OWNERSHIP OF THE SOFTWARE SHALL AT ALL TIMES REMAIN 
IN DEC. 

THE INFORMATION IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT 
NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL 
EQUIPMENT CORPORATION. 

DEC ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF 
ITS SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DEC. 



i 



.MACRO PKTDF$,L,B 



ASYNCHRONOUS SYSTEM TRAP CONTROL BLOCK OFFSET DEFINITIONS 

SOME POSITIONAL DEPENDENCIES BETWEEN THE OCB AND THE AST CONTROL BLOCK 

ARE RELIED UPON IN THE ROUTINE $FINXT IN THE MODULE SYSXT. 
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( 







, 


ASECT 




, = 


=177774 






A 


KSR5 


: 'L 


■ .BLKW 1 


A 


DQSR 


:'L 


' .BLKW 1 






, 


BLKW 


1 


A 


CBL: 


'L' 


.BLKW 


1 


A 


BYT: 


•L' 


.BLKW 


1 


A 


AST: 


•L- 


.BLKW 


1 


A 


NPR: 


'L' 


.BLKW 


1 


A 


PRM: 


■L- 


.BLKW 


1 



; SUBROUTINE KISAR5 BIAS (A.CBL=0) 

; DEQUEUE SUBROUTINE ADDRESS (A.CBL=0) 

;AST QUEUE THREAD WORD 

; LENGTH OF CONTROL BLOCK IN BYTES 

; NUMBER OF BYTES TO ALLOCATE ON TASK STACK 

;AST TRAP ADDRESS 

; NUMBER OF AST PARAMETERS 

; FIRST AST PARAMETER 



\*-. 



.ASECT 



.=0 



.BLKW 



A. CBL: 'L' 
A. BYT: 'L' 
A. AST: 'L' 
A. NPR: 'L' 
A. PRM: 'L' 



.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 



;AST QUEUE THREAD WORD 

; LENGTH OF CONTROL BLOCK IN BYTES 

;NUMBER OF BYTES TO ALLOCATE ON TASK STACK 

;AST TRAP ADDRESS 

; NUMBER OF AST PARAMETERS 

; FIRST AST PARAMETER 



( 



; + 



I/O PACKET OFFSET DEFINITIONS 



.ASECT 



.=0 

I.LNK: 

I . PRI : 

I.EFN: 

I.TCB: 

I.LN2: 

I.UCB: 

I.FCN: 

I.IOSB 



•L' 
■L' 

'L' 
'L' 
'L' 
■L' 

'L' 
: 'L' 



.BLKW 
.BLKB 
.BLKB 
.BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 



.BLKW 
.BLKW 
I.AST:'L' .BLKW 
I.PRM:'L' .BLKW 
.BLKW 
.BLKW 
I.LGTH='B' . 

. PSECT 



I/O QUEUE THREAD WORD 

REQUEST PRIORITY 

EVENT FLAG NUMBER 

TCB ADDRESS OF REQUESTOR 

POINTER TO SECOND LUN WORD 

POINTER TO UNIT CONTROL BLOCK 

I/O FUNCTION CODE 

VIRTUAL ADDRESS OF I/O STATUS BLOCK 

I/O STATUS BLOCK RELOCATION BIAS 

I/O STATUS BLOCK ADDRESS 

AST SERVICE ROUTINE ADDRESS 

RESERVED FOR MAPPING PARAMETER #1 

PARAMETERS 1 TO 6 

USER MODE DIAGNOSTIC PARAMETER WORD 

LENGTH OF I/O REQUEST CONTROL BLOCK 



.MACRO PKTDF$ X,Y 

.ENDM 

.ENDM 

.IIF NDF S$$YDF , .LIST 



,IIF NDF S$$YDF 



.NLIST 



COPYRIGHT (C) 1974,1976,1977 

DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS. 

THIS SOFTWARE IS FURNISHED UNDER A LICENSE FOR USE ONLY ON 
SINGLE COMPUTER SYSTEM AND MAY BE COPIED ONLY WITH THE 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE, OR 
ANY OTHER COPIES THEREOF, HAY NOT BE PROVIDED OR OTHERWISE 
MADE AVAILABLE TO ANY OTHER PERSON EXCEPT FOR USE ON SUCH 
SYSTEM AND TO ONE WHO AGREES TO THESE LICENSE TERMS. TITLE 
TO AND OWNERSHIP OF THE SOFTWARE SHALL AT ALL TIMES REMAIN 
IN DEC. 
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THE INFORMATION IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT 
NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL 
EQUIPMENT CORPORATION. 

DEC ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF 
ITS SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DEC. 



f 



.MACRO SCBDFS,L,B,SYSDEF 



STATUS CONTROL BLOCK 

THE STATUS CONTROL BLOCK (SCB) DEFINES THE STATUS OF A DEVICE CONTROLLER. 
THERE IS ONE SCB FOR EACH CONTROLLER IN A SYSTEM. THE SCB IS POINTED TO 
BY UNIT CONTROL BLOCKS. TO EXPAND ON THE TELETYPE EXAMPLE ABOVE, EACH TELE- 
TYPE INTERFACED VIA A DLll-A WOULD HAVE A SCB SINCE EACH DLll-A IS AN IN- 
DEPENDENT INTERFACE UNIT. THE TELETYPES INTERFACED VIA THE DHll WOULD ALSO 
EACH HAVE AN SCB SINCE THE DHll IS A SINGLE CONTROLLER BUT MULTIPLEXES MANY 
UNITS IN PARALLEL. 



,=1777 
S.RCNT 
S . ROFF 
S . BMSV 
S.BMSK 
S.LHD: 
S . PRI : 
S.VCT: 
S.CTM: 
S.ITM: 
S . CON : 
S . STS : 
S.CSR: 
S.PKT: 
S . FRK : 



.ASECT 
72 
: 'L 



L 
L 
: 'L 
•L' 
'L' 
'L' 
•L' 
'L' 
■L' 
•L' 
'L' 
•L' 
■L' 



.BLKB 
.BLKB 
.BLKW 
.BLKW 
.BLKW 
.BLKB 
.BLKB 
.BLKB 
.BLKB 
.BLKB 
.BLKB 
.BLKW 
• BLKW 
.BLKW 
.BLKW 
.BLKW 
.BLKW 



.IF NB SYSDEF 

.IF DF L$$DRV & M$$MGE 

.BLKW 1 

.ENDC 



S.CCB: 
S.MPR: 



■L" 
'L' 



.BLKW 6 



NUMBER OF REGISTERS TO COPY ON ERROR 

OFFSET TO FIRST DEVICE REGISTER 

SAVED I/O ACTIVE BITMAP AND POINTER TO EMB 

DEVICE I/O ACTIVE BIT MASK 

CONTROLLER I/O QUEUE LISTHEAD 

DEVICE PRIORITY 

INTERRUPT VECTOR ADDRESS /4 

CURRENT TIMEOUT COUNT 

INITIAL TIMEOUT COUNT 

CONTROLLER INDEX 

CONTROLLER STATUS (0=IDLE , 1=BUSY) 

ADDRESS OF CONTROL STATUS REGISTER 

ADDRESS OF CURRENT I/O PACKET 

FORK BLOCK LINK WORD 

FORK-PC 

F0RK-R5 

F0RK-R4 



; FORK-DRIVER RELOCATION BASE 



;MIXED MASSBUS CHANNEL CONTROL BLOCK 

; 11/70 EXTENDED MEMORY UNIBUS DEVICE C-BLOCK 



I 



.IFF 

.PSECT 

I- 
STATUS CONTROL BLOCK PRIORITY BYTE CONDITION CODE STATUS BIT DEFINITIONS 



SP.EIP='B'l 
SP.ENB='B'2 
SP.L0G='B'4 



; ERROR IN PROGRESS (1=YES) 

; ERROR LOGGING ENABLED (0=YES) 

;ERROR LOGGING AVAILABLE (1=YES) 



€ 
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( 



SPARE=10 ; SPARE BIT 

+ 
MAPPING ASSIGNMENT BLOCK (FOR UNIBUS MAPPING REGISTER ASSIGNMENT) 



( 





•ASECT 




.=0 






M.LNK: ■ 


L' .BLKW 


1 


M.UMRA: 


'L' .BLKW 


1 


M.tlMRN: 


• L ' . BLKW 


1 


M.UMVL: 


'L' .BLKW 


1 


M.UMVH: 


'L' .BLKB 


1 


M.BFVH: 


'L' .BLKB 


1 


M.BFVL: 


' L ' . BLKW 


1 


M.LGTH= 


'B' . 
.ENDC 






.MACRO SCBDF$,X,Y,Z 




.ENDM 






.ENDM 





;LINK WORD 

;ADDRESS OF FIRST ASSIGNED OMR 

;NUMBER OF OMR'S ASSIGNED * 4 

;LOW 16 BITS MAPPED BY 1ST ASSIGNED UMR 

;HIGH 2 BITS MAPPED IN BITS 4 AND 5 

;HIGH 6 BITS OF PHYSICAL BUFFER ADDRESS 

;LOW 16 BITS OF PHYSICAL BUFFER ADDRESS 

; LENGTH OF MAPPING ASSIGNMENT BLOCK 



•IIP NDF S$$YDF , .LIST 
.IIF NDF S$$YDF , .NLIST 



( 



COPYRIGHT (C) 1974,1976,1977 

DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS. 

THIS SOFTWARE IS FURNISHED UNDER A LICENSE FOR USE ONLY ON A 
SINGLE COMPUTER SYSTEM AND MAY BE COPIED ONLY WITH THE 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE, OR 
ANY OTHER COPIES THEREOF, MAY NOT BE PROVIDED OR OTHERWISE 
MADE AVAILABLE TO ANY OTHER PERSON EXCEPT FOR USE ON SUCH 
SYSTEM AND TO ONE WHO AGREES TO THESE LICENSE TERMS. TITLE 
TO AND OWNERSHIP OF THE SOFTWARE SHALL AT ALL TIMES REMAIN 
IN DEC. 

THE INFORMATION IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT 
NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL 
EQUIPMENT CORPORATION. 

DEC ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF 
ITS SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DEC. 



•MACRO TCBDF$,L,B,SYSDEF 



c. 



TASK CONTROL BLOCK OFFSET AND STATUS DEFINITIONS 
TASK CONTROL BLOCK 



.ASECT 
.=0 

T.LNK: 'L' .BLKW 1 
T.PRI: 'L' .BLKB 1 
T.IOC: "L" .BLKB 1 
T.CPCB: 'L' .BLKW 1 
T.NAM: 'L' .BLKW 2 
T.RCVL: 'L' .BLKW 2 



; UTILITY LINK WORD 

;TASK PRIORITY 

;I/0 PENDING COUNT 

; POINTER TO CHECKPOINT PCB 

;TASK NAME IN RAD 50 

; RECEIVE QUEUE LISTHEAD 
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T 


.ASTL 


: 'L 


•BLKW 2 


T 


.EFLG 


: 'L 


.BLKW 2 


•T 


.UCB: 


'L' 


.BLKW 1 


T 


.TCBL 


•L 


.BLKW 1 


T 


.STAT 


■•L 


.BLKW 1 


T 


.ST2: 


L- 


.BLKW 1 


T 


.ST3: 


L' 


•BLKW 1 


T 


DPRI 


■L' 


.BLKB 1 


T 


LBN: 


L' 


.BLKB 3 


T 


LDV: 


L' 


.BLKW 1 


T 


PCB: 


L" 


.BLKW 1 


T 


MXSZ 


■L' 


.BLKW 1 


T 


ACTL 


■L- 


.BLKW 1 


T 


ATT: 


L' 


.BLKW 2 


T 


OFF: 


L' 


.BLKW 1 






.BLKB 1 


T 


SRCT: 


'L' 


.BLKB 1 


T. 


RRFL: 


•L' 


.BLKW 2 






.IF NB SYSDEF 






.IF NDF P$$LAS 


T, 


LGTH= 


•B' 


T.ATT 






.IFF 


T. 


LGTH= 


'B' 


. 






,ENDC 


T. 


EXT=' 


B'O 





;AST QUEUE LISTHEAD 

;TASK LOCAL EVENT FLAGS 1-32 

;UCB ADDRESS FOR PSEUDO DEVICE 'TI' 

;TASK LIST THREAD WORD 

; FIRST STATUS WORD (BLOCKING BITS) 

/•SECOND STATUS WORD (STATE BITS) 

;THIRD STATUS WORD (ATTRIBUTE BITS) 

; TASK'S DEFAULT PRIORITY 

;LBN OF TASK LOAD IMAGE 

;UCB ADDRESS OF LOAD DEVICE 

;PCB ADDRESS OF TASK PARTITION 

;MAXIMUM SIZE OF TASK IMAGE (MAPPED ONLY) 

;ADDRESS OF NEXT TASK IN ACTIVE LIST 

;ATTACHMENT DESCRIPTOR LISTHEAD 

;OFFSET TO TASK IMAGE IN PARTITION 

; RESERVED 

;SREF WITH. EFN COUNT IN ALL RECEIVE QUEUES 

? RECEIVE BY REFERENCE LISTHEAD 



;LENGTH OF TASK CONTROL BLOCK 



; LENGTH OF TASK CONTROL BLOCK 



f 



c 



; LENGTH OF TCB EXTENSION 



.IFF 



TASK STATUS DEFINITIONS 

FIRST STATUS WORD (BLOCKING BITS) 



TS.EXE='B'100000 

TS.RDN='B" 40000 

TS.MSG='B'200Q0 

TS.NRP='B'10000 

TS.RUN='B'4000 

TS.OUT='B'400 

TS.CKP='B'200 

TS.CKR='B'100 



; + 



;TASK NOT IN EXECUTION (1=YES) 
;I/0 RUN DOWN IN PROGRESS (1=YES) 
;ABORT MESSAGE BEING OUTPUT (1=YES) 
;TASK MAPPED TO NONRESIDENT PARTITION 
;TASK IS RUNNING ON ANOTHER PROCESSOR 
;TASK IS OUT OF MEMORY (1=YES) 
;TASK IS BEING CHECKPOINTED (1=YES) 
;TASK CHECKPOINT REQUESTED (1=YES) 



(1=YES) 
(1=YES) 



c 



TASK BLOCKING STATUS MASK 



TS.BLK='B'TS,CKP!TS.CKR!TS.EXE!TS.MSG]TS.NRP!TS.OUT!TS.RDN ; 

+ 
SECOND STATUS WORD (STATE BITS) 



T2.AST='B'100000 
T2.DST='B'40000 
T2.CHK='B'2000a 
T2.CKD='B'10000 



;AST IN PROGRESS (1=YES) 
;AST RECOGNITION DISABLED (1=YES) 
;TASK NOT CHECKPOINTABLE (1=YES) 
; CHECKPOINTING DISABLED (1=YES) 



c 
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( 



T2.BFX-'B 
T2.FXD='B 
T2.TI0='B 
T2.CAF='B 
T2.HLT='B 
T2.AB0='B 
T2.STP='B 
T2.STP='B 
T2.SPN='B 
T2 . SPN= ' B 
T2.WFR='B 
T2.WFR='B 



'4000 

■2000 

■1000 

'400 

'200 

= 100 

•40 

•20 

•10 

'4 

'2 

'1 



;TASK BEING FIXED IN MEMORY (1=YES) 

;TASK FIXED IN MEMORY (1=YES) 

;TASK IS ENGAGED IN TERMINAL I/O 

;DYN CHECKPOINT SPACE ALLOCATION FAILURE 

;TASK IS BEING HALTED (1=YES) 

;TASK MARKED FOR ABORT (l=iES) 

;TASK STOPPED (1=YES) 

;TASK STOPPED (1=YES) 

; SAVED TS.SPN ON AST IN PROGRESS 

;TASK SUSPENDED (1=YES) 

; SAVED TS.WFR ON AST IN PROGRESS 

;TASK IN WAITFOR STATE (1=YES) 



( 



THIRD STATUS WORD (ATTRIBUTE BITS) 



T3.ACP= 
T3.PMD= 
T3 . REM= 
T3 . PRV= 
T3.MCR= 
T3.SLV= 
T3.CLI= 
T3.CTL= 
T3.RST= 
T3.NSD= 
T3.CAL= 
T3.R0V= 
T3.NET= 



■'B'lOOOOO 

:'B'40000 

:'B'20000 

:'B'10000 

:'B'4000 
= 'B'2000 

:'B'1000 

= 'B'1000 
^'B'400 

:'B'200 
:'B'100 

= 'B'40 
■'B'20 



ANCILLARY CONTROL PROCESSOR (1=YES) 

DUMP TASK ON SYNCHRONOUS ABORT {0=YES) 

REMOVE TASK ON EXIT (1=YES) 

TASK IS PRIVILEGED (i=YES) 

TASK REQUESTED AS EXTERNAL MCR FUNCTION (1=YES) 

TASK IS A SLAVE TASK (1=YES) 

TASK IS COMMAND LINE INTERPRETER (1=YES) 

TASK WAS ACTIVATED BY A CONTROLLING TASK (1=YES) 

TASK IS RESTRICTED (1=YES) 

TASK DOES NOT ALLOW SEND DATA 

TASK HAS CHECKPOINT SPACE IN TASK IMAGE 

TASK HAS RESIDENT OVERLAYS 

NETWORK PROTOCOL LEVEL 



( 



.ENDC 

.MACRO TCBDF$ X,Y,Z 

.ENDM 

.ENDM 

.IIF NDF S$$YDF , .LIST 

.IIF NDF S$$YDF , .NLIST 



( 



COPYRIGHT (C) 1974,1976,1977 

DIGITAL EQUIPMENT CORPORATION, MAYNARD , MASS. 

THIS SOFTWARE IS FURNISHED UNDER A LICENSE FOR USE ONLY ON A 
SINGLE COMPUTER SYSTEM AND MAY BE COPIED ONLY WITH THE 
INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE, OR 
ANY OTHER COPIES THEREOF, MAY NOT BE PROVIDED OR OTHERWISE 
MADE AVAILABLE TO ANY OTHER PERSON EXCEPT FOR USE ON SUCH 
SYSTEM AND TO ONE WHO AGREES TO THESE LICENSE TERMS. TITLE 
TO AND OWNERSHIP OF THE SOFTWARE SHALL AT ALL TIMES REMAIN 
IN DEC. 

THE INFORMATION IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT 
NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL 
EQUIPMENT CORPORATION. 

DEC ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF 
ITS SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DEC. 



.MACRO UCBDF$,L,B 
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UNIT CONTROL BLOCK 

THE UNIT CONTROL BLOCK (UCB) DEFINES THE STATUS OF AN INDIVIDUAL DEVICE 

UNIT AND IS THE CONTROL BLOCK THAT IS POINTED TO BY THE FIRST WORD OF 

AN ASSIGNED LUN, THERE IS ONE UCB FOR EACH DEVICE UNIT OF EACH DCB. THE 

UCB'S ASSOCIATED WITH A PARTICULAR DCB ARE CONTIGUOUS IN MEMORY AND ARE 

POINTED TO BY THE DCB. UCB'S ARE VARIABLE LENGTH BETWEEN DCB'S BUT ARE 

OF THE SAME LENGTH FOR A SPECIFIC DCB. TO FINISH THE TELETYPE EXAMPLE ABOVE, 

EACH UNIT ON BOTH INTERFACES WOULD HAVE A UCB. 



c 



.=1777 
U.LUIC 
U.OWN: 
U.DCB: 
U.RED: 
U.CTL: 
U.STS: 
U.UNIT 
U.ST2: 
U.CWl: 
U.CW2: 
U . CW3 : 
U.CW4: 
U.SCB: 
U.ATT: 
U.BUF: 

U.CNT: 
U.ACP= 
U.VCB= 
U.CBF= 
U.UIC= 



.ASECT 
74 
: 'L' .BLKW 1 



.BLKW 
.BLKW 
.BLKW 
.BLKB 
.BLKB 

.BLKB 1 
.BLKB 1 
.BLKW 

• BLKW 
.BLKW 

• BLKW 
.BLKW 

• BLKW 
.BLKW 

.BLKW 
■L" .BLKW 
'B'U.CNT+2 
'B'U.CNT+4 
'B'U.CNT+2 
'B'U.CNT+<9 

.PSECT 



'L' 

'L' 

'L' 

'L' 

'L' 

: 'L' 

•L' 

'L' 

■L" 

'L' 

'L' 

'L' 

■L' 

'L' 



*2> 



LOGIN UIC - MULTI USER SYSTEMS ONLY 

OWNING TERMINAL - MULTI USER SYSTEMS ONLY 

BACK POINTER TO DCB 

POINTER TO REDIRECT UNIT UCB 

CONTROL PROCESSING FLAGS 

UNIT STATUS 

PHYSICAL UNIT NUMBER 

UNIT STATUS EXTENSION 

FIRST DEVICE CHARACTERISTICS WORD 

SECOND DEVICE CHARACTERISTICS WORD 

THIRD DEVICE CHARACTERISTICS WORD 

FOURTH DEVICE CHARACTERISTICS WORD 

POINTER TO SCB 

TCB ADDRESS OF ATTACHED TASK 

RELOCATION BIAS OF CURRENT I/O REQUEST 

BUFFER ADDRESS OF CURRENT I/O REQUEST 

BYTE COUNT OF CURRENT I/O REQUEST 

ADDRESS OF TCB OF MOUNTED ACP 

ADDRESS OP VOLUME CONTROL BLOCK 

CONTROL BUFFER RELOCATION AND ADDRESS 

TERMINAL UIC (TERMINALS ONLY) 



c 



I 



DEVICE TABLE STATUS DEFINITIONS 

DEVICE CHARACTERISTICS WORD 1 (U.CWl) DEVICE TYPE DEFINITION BITS. 



RECORD ORIENTED DEVICE (1=YES} 

CARRIAGE CONTROL DEVICE (1=YES) 

TERMINAL DEVICE (1=YES) 

FILE STRUCTURED DEVICE (1=YES) 

SINGLE DIRECTORY DEVICE (1=YES) 

SEQUENTIAL DEVICE (1=YES) 

MASS BUS DEVICE :(1=YES) 

USER MODE DIAGNOSTICS SUPPORTED 

UNIT SOFTWARE WRITE LOCKED (1=YES) 

PSEUDO DEVICE (1=YES) 

DEVICE IS MOUNTABLE AS COM CHANNEL (1=YES) 

DEVICE IS MOUNTABLE AS Fll DEVICE (1=YES) 

DEVICE IS MOUNTABLE (1=YES) 



TERMINAL DEPENDENT CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS 



DV.REC= 


'B 


1 


DV.CCL= 


'B 


2 


DV.TTY= 


■B 


4 


DV.DIR= 


'B 


10 


DV.SDI= 


'B 


20 


DV.SQD= 


•B 


40 


DV.MXD= 


•B 


100 


DV.UMD= 


'B 


200 


DV.SWL= 


'B 


1000 


DV.PSE= 


'B 


2000 


DV.COM= 


'B 


4000 


DV.F11= 


■B 


40000 


DV.MNT= 


•B 


100000 



I 



U2.DH1='B'100000 
U2.DJ1='B'40000 



;UNIT IS A MULTIPLEXER (l=yES) 
;UNIT IS A DJll (1=YES) 



€ 
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( 



c 



U2.RMT= 
U2.L8S= 
U2.NEC= 
U2.CRT= 
U2.ESC= 
U2 . LOG= 
U2.SLV= 
U2.DZ1= 
U2.HLD= 
U2.AT.= 
U2.PRV= 
U2.L3S= 
U2.VT5= 
U2.LWC= 



■B'20000 

'B'lOOOO 

'B'4000 

■B'2000 

'B'lOOO 

'B'400 

'B'200 

'B'lOO 

'B'40 

'B'20 

'B'lO 

'B'4 

•B'2 

■B'l 



;UNIT IS REMOTE (1=YES) 

;UNIT IS LA180S (1=YES) 

; DON'T ECHO SOLICITED INPUT (1=YES) 

?UNIT IS A CRT (1=YES) 

; UNIT GENERATES ESCAPE SEQUENCES 

;USER LOGGED ON TERMINAL (0=YES) 

;UNIT IS A SLAVE TERMINAL (1=YES) 

;UNIT IS A DZll (1=YES) 

jTERMINAL IS IN HOLD SCREEN MODE 

?MCR COMMAND AT, BEING PROCESSED 

;UNIT IS A PRIVILEGED TERMINAL (l=yES) 

;UNIT IS A LA30S TERMINAL (1=YES) 

?UNIT IS A VT05B TERMINAL (1=YES) 

;LOWER CASE TO UPPER CASE CONVERSION (1=YES) 



(l=yES) 



(1=YES) 
(l=yES) 



RH11-RS03/RS04 CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS 



U2.R04='B'100000 

+ 



;UNIT IS A RS04 (1=YES) 
RH11-Tul5 CHARACTERISTICS WORD 2 (U.CW2) BIT DEFINITIONS 



U2.7CH='B'10000 

+ 



;UNIT IS A 7 CHANNEL DRIVE (1=YES) 
UNIT CONTROL PROCESSING FLAG DEFINITIONS 



DC.ALG='B'200 

UC.NPR= 'B'lOO 

UC.QUE='B'40 

UC.PWF='B'20 

UC.ATT='B'10 

UC.KIL='B'4 

UC.LGH='B'3 



;BYTE ALIGNMENT ALLOWED (1=N0) 
;DEVICE IS AN NPR DEVICE (1=YES) 
;CALL DRIVER BEFORE QUEUING (1=YES) 
;CALL DRIVER AT POWERFAIL ALWAYS (1=YES) 
;CALL DRIVER ON ATTACH/DETACH (1=YES) 
;CALL DRIVER AT I/O KILL ALWAYS (1=YES) 
; TRANSFER LENGTH MASK BITS 



UNIT STATUS BIT DEFINITIONS 



US.BSY='B'200 
US.MNT='B'100 
US.FOR='B'40 
US.MDM='B'2Q 



; + 



;UNIT IS BUSY (1=YES) 

;UNIT IS MOUNTED (0=YES) 

;UNIT IS MOUNTED AS FOREIGN VOLUME (l=yES) 

;UNIT IS MARKED FOR DISMOUNT (1=YES) 



CARD READER DEPENDENT UNIT STATUS BIT DEFINITIONS 



US.ABO='B'l 
US.MDE='B'2 



;UNIT IS MARKED FOR ABORT IF NOT READY (1=YES) 
;UNIT IS IN 029 TRANSLATION NODE (1=YES) 



FILES-11 DEPENDENT UNIT STATUS BITS 



US.WCK="B'10 
US,SPU='B'2 



;WRITE CHECK ENABLED (1=YES) 
;UNIT IS SPINNING UP (1=YES) 



; + 



TERMINAL DEPENDENT UNIT STATUS BIT DEFINITIONS 
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SYSTEM DATA STRUCTURES AND SYMBOLIC DEFINITIONS 



US,DSB="B'10 
US . CRW= ' B ' 4 
US.ECH='B'2 
US.OUT='B'l 



;UNIT IS DISABLED (1=YES) 

;UNIT IS WAITING FOR CARRIER (1=YES) 

;UNIT HAS ECHO IN PROGRESS (1=YES) 

;UNIT IS EXPECTING OUTPUT INTERRUPT (1=YES) 



( 



LPSll DEPENDENT UNIT STATUS BIT DEFINITIONS 



;FORK IN PROGRESS {1=YES) 

; SHAREABLE FUNCTION IN PROGRESS (0='B'YES) 



US.FRK='B'2 
US . SHR= ' B ' 1 

; + 

; ANSI MAGTAPE DEPENDENT UNIT STATUS BITS 

US.LAB='B'4 ;UNIT HAS LABELED TAPE ON IT (1=YES) 

UNIT STATUS EXTENSION (U.ST2) BIT DEFINITIONS 



US.OFL='B'l 
US.RED='B'2 
US.PUB='B'4 
US.UMD='B'10 

.MACRO UCBDF$,X,Y 

.ENDM 

.ENDM 

.IIF NDF S$$YDF 



;UNIT OFFLINE (1=YES) 

;UNIT REDIRECTABLE (0=YES) 

jUNIT IS PUBLIC DEVICE (1=YES) 

;UNIT ATTACHED FOR DIAGNOSTICS (1=YES) 



€ 



.NLIST 



I 
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READER'S COMMENTS 



NOTE: This form is for document comments only. DIGITAL will 
use comments submitted on this form at the company ' s 
discretion. Problems with software should be reported 
on a Software Performance Report (SPR) form. If you 
require a written reply and are eligible to receive 
one under SPR service, submit your comments on an SPR 
form . 



Did you find errors in this manual? If so, specify by page. 



( 



c 



«) 

c 



on 

c 
o 



3 



Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 



is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 



Please indicate the type of user /reader that you most nearly represent. 

Q Assembly language programmer 

I I Higher-level language programmer 

Q Occasional programmer (experienced) 

I I User with little programming experience 

I I Student programmer 

Q Non-programmer interested in computer concepts and capabilities 



Name. 



I 



Date. 



Organization. 
Street 



City. 



.State. 



-Zip Code. 

or 
Country 



- Fold Here - 



' Do Not Tear - Fold Here and Staple - 



c 



c 
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